DeepSeek与Spring AI框架的集成开发教程-人工智能-PHP中文网

Spring AI 官方不提供 DeepSeek 的开箱即用 starter，需手动实现 ChatModel 接口并用 WebClient 对接其 OpenAI 兼容 API；配置须避免使用无效的 spring.ai.providers.deepseek 前缀，而应通过环境变量或自定义配置注入 API Key。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

deepseek与spring ai框架的集成开发教程

Spring AI 官方目前不提供 deepseek-spring-adapter 或 spring-ai-deepseek 这类开箱即用的 starter 模块。所有声称“Spring AI 原生支持 DeepSeek”的教程，实际都依赖手动适配或第三方非官方封装——这点必须先说清，否则后续踩坑全是配置失效、Bean 注入失败、AiClient 调不通。

为什么 Spring AI 的 `AiClient` 不能直接调用 DeepSeek API

Spring AI 的标准流程是：通过 Provider 抽象层 + ChatModel 实现类完成模型调用。但截至 2026 年 5 月，org.springframework.ai 官方 Maven 仓库中仍无 deepseek 相关 artifact（查证坐标 org.springframework.ai:spring-ai-deepseek 返回 404）。它只原生支持 OpenAI、Azure OpenAI、Ollama、Google Gemini 等少数几家。

这意味着你无法靠加一个 dependency 就自动注册 DeepSeekChatModel Bean；也不能用 @Autowired private ChatModel chatModel; 直接拿到能跑 deepseek-chat-7b 的实例。

常见错误现象：

Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'org.springframework.ai.chat.ChatModel' available
配置了 spring.ai.providers.deepseek.api-key，但启动时完全无日志、无报错、也无对应 Bean 初始化
强行写 new DeepSeekChatModel(...) 却发现类根本不存在（IDE 提示 unresolved reference）

用 `RestTemplate` 或 `WebClient` 手动对接 DeepSeek API 是最稳路径

DeepSeek 官方 API（https://api.deepseek.com/v1/chat/completions）完全兼容 OpenAI 格式，这是关键突破口。你可以复用 Spring AI 中已有的 OpenAiChatModel 结构逻辑，但底层换掉 HTTP 客户端目标地址和认证头。

实操建议：

不要试图魔改 spring-ai-openai 的源码去“硬塞” DeepSeek；它绑定了 openai.* 配置前缀和特定的 error 解析逻辑，改起来成本高且易崩
新建一个 DeepSeekChatModel 类，实现 ChatModel 接口，内部用 WebClient 发起 POST 请求
请求头必须带 Authorization: Bearer ${DEEPSEEK_API_KEY}，不是 Api-Key 也不是其他变体
请求体 JSON 结构与 OpenAI 兼容，但 model 字段必须填 deepseek-chat-7b 或 deepseek-v3.2-think（注意大小写和连字符）
响应体中 choices[0].message.content 是你要提取的文本，别漏掉 [0] 下标

示例片段（简化版）：

public class DeepSeekChatModel implements ChatModel {
    private final WebClient webClient;
    private final String apiKey;
    private final String model;
<pre class="brush:php;toolbar:false;">public DeepSeekChatModel(WebClient.Builder builder, String apiKey, String model) {
    this.webClient = builder.baseUrl("https://api.deepseek.com/v1").build();
    this.apiKey = apiKey;
    this.model = model;
}

@Override
public ChatResponse call(ChatRequest request) {
    var body = Map.of(
        "model", model,
        "messages", request.getMessages().stream()
            .map(m -> Map.of("role", m.getRole().toString(), "content", m.getContent()))
            .toList()
    );

    return webClient.post()
        .uri("/chat/completions")
        .header("Authorization", "Bearer " + apiKey)
        .bodyValue(body)
        .retrieve()
        .bodyToMono(JsonNode.class)
        .blockOptional()
        .map(this::parseResponse)
        .orElseThrow(() -> new RuntimeException("DeepSeek API returned no response"));
}

}

Baoyu Danger Gemini Web

通过逆向工程的Gemini网页API生成图像和文本。支持文本生成、提示词图像生成以及用于视觉输入的参考图像等。

下载

`application.yml` 里哪些配置项真有用，哪些是摆设

Spring Boot 启动时会加载所有 spring.* 开头的配置，但 Spring AI 不识别 deepseek.* 自定义前缀。所以以下写法无效：

deepseek:
  api-key: sk-xxx
  endpoint: https://api.deepseek.com/v1

真正该做的只有两件事：

把 DEEPSEEK_API_KEY 设为环境变量（推荐），或在 application.yml 顶层写 deepseek-api-key: ${DEEPSEEK_API_KEY:default_key}
在 @Configuration 类中用 @Value("${deepseek-api-key}") 注入，再传给你的 DeepSeekChatModel 构造器
timeout 和 retry 需自己在 WebClient 构建时配，例如 .codecs(c -> c.defaultCodecs().maxInMemorySize(10 * 1024 * 1024)) 防大响应体 OOM