常见问题

写在最前：问题咨询请直接点击此处提交 ISSUE

• ⭐️ 请先 Star 本项目后再提问，作者精力有限，未 Star 直接 Close
• 🐞 GitHub ISSUE 需包含：问题截图 + SDK版本 + 配置代码

依赖版本冲突问题

目前遇到最多的是 SpringBoot 兼容性问题

Spring Boot 兼容性问题

当使用 Spring Boot 2.4.x 以下版本时，可能会遇到 Jackson 和 OkHttp 的版本冲突问题。这是因为较低版本的 Spring Boot 依赖的这些库版本与 deepseek4j 所需版本不兼容。

解决方案

请将以下依赖管理配置添加到项目根 pom.xml 文件的 dependencyManagement 节点中，以确保全局依赖版本的正确覆盖。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
            <version>4.12.0</version>
        </dependency>
        <dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp-sse</artifactId>
            <version>4.12.0</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson</groupId>
            <artifactId>jackson-bom</artifactId>
            <version>2.12.4</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

中文编码问题

问题描述

如果开发环境的字符编码不是 UTF-8，或在输出响应时遇到中文乱码问题，可能会出现如下情况：

解决方案

在 Spring Controller 中设置响应的 Content-Type 时，需要明确指定字符编码为 UTF-8：

@GetMapping(value = "/chat", produces = MediaType.TEXT_EVENT_STREAM_VALUE + ";charset=UTF-8")
public Flux<ChatCompletionResponse> chat(String prompt) {
    // 你的业务逻辑
}

多厂商动态切换

问题描述

在某些场景下，可能需要根据不同的业务需求动态切换不同的模型厂商。例如，在某些场景下，可能需要根据不同的业务需求动态切换不同的模型厂商。

解决方案

• 不再引入 deepseek-spring-boot-starter 依赖，而是引入 deepseek4j-core 依赖自行配置 DeepSeekClient

@Bean
public DeepSeekClient aliyunDeepSeekClient() {
    DeepSeekClient.Builder builder = DeepSeekClient.builder().baseUrl(deepSeekProperties.getBaseUrl())
            .model(deepSeekProperties.getModel()).openAiApiKey(deepSeekProperties.getApiKey())
            .logRequests(deepSeekProperties.isLogRequests()).logResponses(deepSeekProperties.isLogResponses());
    return builder.build();
}


@Bean
public DeepSeekClient txDeepSeekClient() {

    DeepSeekClient.Builder builder = DeepSeekClient.builder().baseUrl(deepSeekProperties.getBaseUrl())
            .model(deepSeekProperties.getModel()).openAiApiKey(deepSeekProperties.getApiKey())
            .logRequests(deepSeekProperties.isLogRequests()).logResponses(deepSeekProperties.isLogResponses());
    return builder.build();
}

API 使用量统计

获取请求用量统计

Deepseek 官方 API 会在流式响应的最后返回本次请求的用量统计信息。你可以通过以下方式获取：

return deepSeekClient.chatFluxCompletion(prompt)
    .doOnNext(response -> {
        if (Objects.nonNull(response.usage())) {
            // 在这里处理用量统计信息
            // 可以记录到日志或数据库中
        }
    });

PIG AI应用开发平台 | 适合中大型企业构建自主可控的AI中台

为Java开发者提供全栈式AI工程化解决方案，强类型/高可维护性架构，内置30+主流大模型支持。

• 🔍 知识引擎体系：RAG 知识引擎全自动化多模态解决方案
• 📝 AI-OCR 中枢：复杂非标场景高精度识别
• ⚙️ 业务智能融合：函数编排 + Chat2SQL，无缝对接现有业务系统
• 🛡️ N维风控体系：敏感词/IP/Token/User 规则控制引擎

文档有误？请协助编辑

发现文档问题？点击此处直接在 GitHub 上编辑并提交 PR，帮助我们改进文档！