Spring AI 入门：DeepSeek 集成、角色设定与流式输出

介绍基于 Spring AI 框架集成 DeepSeek 大模型的方法。内容包括 Maven 项目依赖配置、通过 ChatClient 发送请求获取响应、自定义系统角色（System Prompt）以及使用 SSE 流式输出实现前端实时展示。此外，还提供了在本地环境访问外部 API 时配置 HTTP/HTTPS 代理的解决方案。

暖阳发布于 2026/3/30更新于 2026/4/131 浏览

Spring AI 快速入门

官方资源

Spring AI 官网

创建项目

1. Maven 配置

引入 Spring Boot 和 Spring AI 依赖。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.qi</groupId>
    <artifactId>springAI_demo06</artifactId>
    <version>1.0-SNAPSHOT</version>
    
    <dependencyManagement>
        <dependencies>
            <!-- Spring Boot BOM -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>3.4.3</version>
                <>pom
                import
            
            
            
                org.springframework.ai
                spring-ai-bom
                1.0.0
                pom
                import
            
        
    

    
        
            org.springframework.boot
            spring-boot-starter-web
        
        
        
            org.springframework.ai
            spring-ai-starter-model-deepseek

相关免费在线工具

Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online
Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online
JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online
JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online
RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。在线工具，Mermaid 预览与可视化编辑在线工具，online

spring:
  ai:
    deepseek:
      api-key: sk-xxxxxxxxx
      base-url: https://api.deepseek.com

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/my")
class MyController {
    private final ChatClient chatClient;

    public MyController(ChatClient.Builder chatClientBuilder) {
        this.chatClient = chatClientBuilder.build();
    }

    @GetMapping("/ai")
    public String generation(@RequestParam("message") String message) {
        return this.chatClient.prompt()
                .user(message)
                .call()
                .content();
    }
}

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Config {
    @Bean
    ChatClient chatClient(ChatClient.Builder builder) {
        return builder.defaultSystem("你现在是斩神神经病院的一个客服，需要为客户解答。我们神经病院的院长叫林七夜，他最擅长的就是精神分裂治疗。").build();
    }
}

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Flux;

@RestController
public class StreamController {
    private final ChatClient chatClient;

    public StreamController(ChatClient.Builder builder) {
        this.chatClient = builder.build();
    }

    @GetMapping(value = "/stream", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
    public Flux<String> stream(@RequestParam("message") String message) {
        return chatClient.prompt()
                .user(message)
                .stream()
                .content();
    }
}

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ApplicationProxy {
    public static void main(String[] args) {
        // 代理配置
        String proxyHost = "127.0.0.1";
        int proxyPort = 7897;

        System.setProperty("http.proxyHost", proxyHost);
        System.setProperty("http.proxyPort", String.valueOf(proxyPort));
        System.setProperty("https.proxyHost", proxyHost);
        System.setProperty("https.proxyPort", String.valueOf(proxyPort));
        System.setProperty("socksProxyHost", proxyHost);
        System.setProperty("socksProxyPort", String.valueOf(proxyPort));

        SpringApplication.run(ApplicationProxy.class, args);
    }
}

Spring AI 入门：DeepSeek 集成、角色设定与流式输出

Spring AI 快速入门

官方资源

创建项目

1. Maven 配置

更多推荐文章

相关免费在线工具

2. 配置文件 (application.yml)

3. 基础调用示例

预设系统角色

流式输出 (SSE)

代理配置

Spring AI 入门：DeepSeek 集成、角色设定与流式输出

Spring AI 快速入门

官方资源

创建项目

1. Maven 配置

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

2. 配置文件 (application.yml)

3. 基础调用示例

预设系统角色

流式输出 (SSE)

代理配置