先说说啥是 Spring Boot 和 LangChain4j

哎，先把概念给掰开揉碎了。

Spring Boot 就是那套让你写 Java 程序像搭积木一样的框架，省掉一大堆配置活儿。

LangChain4j 则是 Java 版的 LangChain，帮你把大模型和业务代码黏在一起，像胶水一样。

两者一碰撞，就Neng把 AI Neng力塞进你的微服务里简直是天作之合。

为啥要把它们合体？

说实话，你可NengYi经玩过 OpenAI 的 API，手动拼请求、解析 JSON、写工具调用，这事儿挺麻烦的。

Spring Boot Neng管好生命周期、依赖注入、日志啥的；LangChain4j Neng帮你管理 Prompt、Tool、Memory。

把它们绑在一起，你只需要专注业务逻辑，其他的交给框架搞定。

准备工作：依赖和配置

把下面这几段依赖丢进你的 pom.xml，别忘了版本号对上。

    dev.langchain4j
    langchain4j-spring-boot-starter
    0.30.0


    dev.langchain4j
    langchain4j-openai
    0.30.0


    org.springframework.boot
    spring-boot-starter-web

接下来在 application.yml 里写点配置：

langchain4j:
  open-ai:
    chat-model:
      api-key: YOUR_API_KEY
      base-url: https://api.openai.com/v1
      model-name: gpt-4o-mini
      temperature: 0.7
      max-tokens: 1024

注意点：别忘了把 API Key 放安全的地方

建议用环境变量或 Spring Cloud Config，把钥匙藏起来别硬编码在代码里。哈哈，那可不安全啊。

实现步骤：从零到有 1️⃣ 定义一个 AI Service 接口

用 @AiService 注解，让 LangChain4j 自动生成实现。

@AiService
public interface MyAssistant {
    @SystemMessage
    String chat;
}

这样，你只需要注入 MyAssistant，调用 .chat 就Neng得到模型回复啦。

2️⃣ 加点工具让模型会“动手”

想让 AI Neng查询数据库、发送邮件或者预订会议室？给它们加个 @Tool 注解就行。

@Service
public class BusinessTools {
    @Tool
    public String checkStock String productId) {
        // 假装去查库
        return "商品 " + productId + " 库存还有 42 件";
    }
    @Tool
    public String sendReminder(
            @ToolParam String email,
            @ToolParam String content) {
        // 发邮件逻辑...
        return "Yi向 " + email + " 发送提醒";
    }
}

Crap，这里有个小坑：Ru果你用了 Lombok 的 @Slf4j，记得手动导入 Logger，否则启动会报错。不要装酷，我也经常踩这个坑。

3️⃣ 把 Tool 暴露给 LangChain4j

AiServices.builder 时把工具注入进去：

@Bean
public MyAssistant myAssistant {
    return AiServices.builder
            .chatModel
            .tools
            .build;
}

4️⃣ 写个 Controller 当入口

@RestController
@RequestMapping
public class AssistantController {
    private final MyAssistant assistant;
    public AssistantController {
        this.assistant = assistant;
    }
    @GetMapping
    public String chat {
        return assistant.chat;
    }
}

P.S. 别忘了加上跨域配置，不然前端调不了接口。哈哈，这事儿常被新人忽视。

进阶玩点：多轮对话与自动 Tool 调用

Clever folks want more than one‑shot answers.

L​angChain4j 支持“function calling”。当模型返回 tool 调用请求时你得把结果再喂回模型，让它继续推理。

@Service
public class AdvancedAgent {
    private final ChatModel chatModel;
    private final BusinessTools tools;
    public AdvancedAgent {
        this.chatModel = chatModel;
        this.tools = tools;
    }
    public String converse {
        List history = new ArrayList<>;
        history.add);
        while  {
            ChatResponse response = chatModel.chat
                    .messages
                    .functions)   // 把工具转成 FunctionSpec 列表
                    .build);
            Message lastMsg = response.message;
            history.add;
            if ) {
                return lastMsg.text;   // 没有函数调用，直接返回答案
            }
            // 有函数调用 → 执行工具 → 把结果塞回历史 → 
请求模型
            FunctionCall call = lastMsg.functionCall;
            Object result = tools.invoke, call.arguments);
            history.add, result.toString));
        }
    }
}

P.S. 那个 .functions) 参数名在不同版本里可Neng叫 .tools)，别装死，我也是刚发现的，不对不对，是 .functionSpecifications)……kan文档就好啦。

随手插一句：为什么百度不收录我的技术博客？🤔

这个问题经常被小伙伴问，我来凑个热闹：

# 内容重复度高：搜索引擎嫌同质化，会降权；所以尽量写独特的案例和个人经验吧。

# 缺少外链：没有其他站点指向，你的页面就像孤岛，爬虫不爱来访。

# 页面加载慢：SSE、JS 大文件拖慢首屏渲染，会被判低质量。

# 没配好 robots.txt 或 meta robots：`noindex` 一键让搜索引擎滚蛋。

懂得的话就去检查一下这些细节，别再等百度不给收录了。咱就是说这招挺管用的！😂

实战案例：企业内部助手上线记 🚀

A 公司想搞一个内部 AI 助手，Ke以帮员工查询公告、预定会议室、请假——听起来hen酷对吧？下面就是他们怎么一步步实现的：

# 步骤一：定义工具类 # 步骤二：创建 Spring Bean 并注入 AiService

@Configuration
public class LangChainConfig {
   @Bean
   public CompanyAssistant companyAssistant {
       return AiServices.builder
               .chatModel
               .tools
               .build;
   }
}

# 步骤三：暴露 HTTP 接口供前端调用

@RestController
@RequestMapping
public class CompanyController {
   private final CompanyAssistant assistant;
   public CompanyController {
       this.assistant = assistant;
   }
   @PostMapping
   public ResponseEntity talk {
       String question = payload.getOrDefault;
       if ) return ResponseEntity.badRequest.body;
       return ResponseEntity.ok);
   }
}

A 公司上线后同事们惊呼：“这也太智Neng了吧！” 毕竟之前要打开多个系统才Neng完成请假，现在一句话全搞定。哈哈，这就是 AI 带来的生产力提升呀！🥳

Troubleshooting 小贴士

# Bean 循环依赖：AiService 本身会自动注入 ChatModel，Ru果你手动声明了 ChatModel 又用了 @ConfigurationProperties，会导致循环。解决办法是把 ChatModel 放到单独的配置类里不要互相引用。

# 工具参数类型不匹配：L​angChain4j 要求 JSON Schema 中的类型必须和方法签名对应，否则运行时会抛异常。记得把 int 改成 Integer 或者在 @ToolParam 上注明 type="integer"。

# SSE 长连接被防火墙拦截：SSE 用于实时推送 tool 调用结果。Ru果公司网络限制长连接，就改成普通 HTTP RPC 模式即可——只要保证 client Neng同步调用返回值就行。

# 日志太多卡住控制台：SprintBoot 默认开启 DEBUG 日志，在开发阶段Ke以调低到 INFO，否则kan到一大堆 “Sending request to …”。记得在 application.yml 里加：

logging:
  level:
     dev.langchain4j: INFO
     org.springframework.web: WARN
 

# “tool not found” 错误：L​angChain4j 在构造 FunctionSpec 时会根据方法名生成 tool 名称。Ru果你用了驼峰命名，需要确保前端请求中的 name 与之匹配，否则模型找不到对应函数。Ke以通过 @Tool 自定义名称避免冲突。

\end{ul}

——老友寄语 🎤

Crap，说到底，把 Spring Boot 和 LangChain4j 合体并不是高深莫测的黑科技，只是把两套成熟生态拼起来罢了。关键是敢动手、敢实验，然后不断调参、修 bug——过程可Neng比写业务代码geng刺激哦！哈哈，你要是还担心学习成本，那就先跑通Zui基础的 “一句话聊天”，再逐步加 Tool，一步一个脚印，总Neng到达目的地。咱就是说加油啊！Ru果有什么坑卡住随时来聊，我这儿永远有热咖啡等着陪你 debug~ 😄

---