覆蓋 ChatModel/AiServices 裝配、@Tool 與 MCP、進程內 Embedding、結構化輸出與版本升級等 LangChain4j 集成中的高頻坑。
版本升級、NoSuchMethodError/NoClassDefFoundError、BOM、starter 兼容
LangChain4j 1.x 將 ChatLanguageModel 改名為 ChatModel，編譯報找不到符號，版本不齊則會運行期崩潰。
LangChain4j core 升級後類被刪，上層集成仍引用舊類，運行期報 NoClassDefFoundError。
LangChain4j 1.x 編譯基線是 JDK 17，丟進 Java 8 運行會在加載類時拋 UnsupportedClassVersionError。
Spring Boot 4 下 LangChain4j starter 自動裝配失敗，報 Failed to generate bean name。
provider 設定、api-key、baseUrl、模型名
LangChain4j Vertex Gemini 多輪工具調用第二輪拋 400 missing thought_signature，適配層未回傳簽名。
Ollama 模型名寫錯時 LangChain4j 拋 NPE，真實原因是 /api/chat 返回 404、響應體為空。
Spring Boot 4 下 LangChain4j starter 自動裝配失敗，報 Failed to generate bean name。
@Tool、參數映射、MCP、stdio
LangChain4j Vertex Gemini 多輪工具調用第二輪拋 400 missing thought_signature，適配層未回傳簽名。
MCP stdio 報 JsonParseException 常是子進程沒起來：命令拼成單串、路徑帶空格，stderr 中文報錯被當 JSON 解析。
Java 預設不保留參數名，LangChain4j 的 @Tool 映射不到實參：或靜默為 null，或拋 MissingArgumentException。
進程內 embedding、DJL/ONNX、原生庫
StreamingChatModel、TokenStream、Flux
超時、429、連接、代理
