本文记录一次基于 Spring AI 的 MCP（Model Context Protocol）实践项目联调过程，包含四个真实踩坑的完整排查与解决记录。技术栈：Spring Boot 3.5.11 + Spring AI 1.1.2 + MCP Java SDK 0.17.0 + JDK 21。
一、项目背景项目包含两个模块：
mcp-tools-server：MCP 服务端，提供工具、资源、提示词
mcp-tools-client：MCP 客户端，通过 stdio 方式启动并连接服务端
整个联调过程踩了四个坑，从”进程启动即失败”到”能连上但工具列表为空”，下面逐一记录。
二、坑一：addEnvVar 误用导致服务端进程根本没启动现象客户端启动时报错：
12java.util.concurrent.TimeoutException: Did not observe any item or terminal signal within 20000ms in 'map'Caused by: java.lang.RuntimeException: Client ...
Linux
未读本文基于 2026-10-14 在一台 Windows 11 Home China 上的完整实操记录，包含全部真实踩坑过程与解决方案。适用于：程序装 D 盘、内存受限、国内网络环境、跑 Redis / PostgreSQL 的个人开发场景。
一、环境背景先交代一下我的机器情况，方便大家对号入座：
项目
值
系统
Windows 11 Home China，版本 26200
内存
16 GB
C 盘
约 31 GB 可用（紧张，所以一切装 D 盘）
D 盘
约 49 GB 可用
WSL
3.0.1 已预装
已有软件
PostgreSQL 18（占用 5432 端口）
网络
国内直连 Docker Hub 不通，有 Clash 代理
最终成果：
项目
结果
程序本体
D:\Docker\Program
WSL2 数据盘
D:\Docker\WSL（容器/镜像/卷全在这）
虚拟机内存上限
4 GB（.wslconfig）
Redis
localhost:6379，AOF 持久化
Postgr ...
前言之前学习了python的langchain,一直觉得学得模模糊糊的，本来对python的使用比较陌生，还是干回java老本行吧学起来都要顺手一些这篇文章是学习springai的上半部分，主要是学习时遇到的问题解决还有自己对springai的理解如有错误请指正
springai项目的搭建问题在项目初期搭建的时候，配置依赖的时候遇到依赖冲突的问题，我们当前使用的时Spring AI 2.0.1 版本，在构建maven的时候使用的是3.5.11版本进行统一的构建。根据官方参考文档
12345678910111213141516171819Spring AI 2.0.x 支持 Spring Boot 4.0.x 和 4.1.x。``可见Spring AI 2.0.x 支持 Spring Boot 4.0.x 和 4.1.x，同时这里注意，根据官方要求jdk版本在jdk21以上，这里我使用的是jdk21版本读者如果需要选择合适的版本，需要去官网https://docs.spring.io/spring-ai/reference/getting-started.html查看支持的版本避免出现同 ...
一、引言锁是并发编程的基石，Java提供了丰富的锁机制来保证线程安全。本文将从JVM底层到应用层，全面剖析Java线程锁的核心原理与高级用法。
本文基于 JDK 17 源码分析，涉及大量底层实现细节，适合有一定并发编程基础的开发者。
二、synchronized 底层实现2.1 对象头与 Mark Word每个Java对象在内存中的布局包括对象头、实例数据和对齐填充。对象头中的 Mark Word 存储了锁状态信息：
123456789┌─────────────────────────────────────────────────────┐│ Mark Word (64bit) │├─────────────────────────────────────────────────────┤│ 无锁状态: unused:25 | hash:31 | age:4 | biased:0 | 01 ││ 偏向锁: thread:54 | epoch:2 | age:4 | biased:1 | 01 ││ 轻 ...
一、引言在当今互联网时代，高并发处理能力是系统架构的核心竞争力。Java作为企业级应用的主流语言，其并发编程机制经过多年发展已经相当成熟。本文将深入探讨Java高并发编程的核心原理、实战技巧和性能优化策略。
本文适合有一定Java基础的开发者，重点讲解并发编程的底层原理和高级优化技巧。
二、Java内存模型（JMM）深度解析2.1 内存可见性问题Java内存模型定义了线程之间共享变量的可见性规则。每个线程都有自己的工作内存，变量修改需要同步到主内存才能被其他线程看到。
1234567891011121314// 可见性问题示例public class VisibilityProblem { private boolean flag = true; public void writer() { flag = false; // 线程1修改 } public void reader() { while (flag) { // 线程2可能永远看不到修改 ...
前言现在开发中一般都是采用父子工程的方式来进行开发,因为这样可以更好的管理项目,也可以更好的解耦项目.因为我用得上所以我准备写个教程作为以后的参考.就怕自己以后再用的时候忘记了.下面会从以下几个方面来进行讲解:
父工程创建
子工程创建
父子工程配置
父工程创建使用idea中自带的模板来创建(下面有图片如果没有显示,需要重新刷新几次网页,我用的免费图床所以有点卡后面文章中如果有图片的地方我就简写如图)
下面的勾选我这边建议是勾选基本的就行了（当然你至少要把spring web勾上）如图:
修改pom文件修改父工程下的pom文件中的打包方式为pom，如图:idea会自动设置为父工程这里我会提供一个基础的父工程的pom.xml文件参考
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657<?xml version="1.0" encoding="UTF-8"?><projec ...
SpringMVC RequestMapping1. 概述在Spring MVC中，@RequestMapping注解用于将HTTP请求映射到控制器类或控制器方法。它是Spring MVC的核心注解之一，用于构建RESTful API。
2. 映射方式2.1 类级别映射在控制器类上使用@RequestMapping注解，可以为该控制器的所有方法指定一个公共的URL前缀。
12345@RequestMapping("/api/users")@RestControllerpublic class UserController { // 控制器方法}
2.2 方法级别映射在控制器方法上使用@RequestMapping注解，指定具体的URL路径和HTTP方法。
1234567891011121314@RequestMapping("/api/users")@RestControllerpublic class UserController { @RequestMapping(value = " ...
Dart基础Dart变量声明-var12345678void main(List<String> args) { var age = 20; print(age); age =21; print(age); var age1= "测试1"; print(age1);}
语法: var 变量名=值/表达式;
注意:当声明的变量类型第一次以后不能再更改其类型,例如:上述代码中不能将age在下面赋值String类型的值
Dart常量声明-const1234567891011void main(List<String> args) { const num=3.1415926; print(num); num=100;//错误写法1 const length = 2* num*10; print(length); //第二种 var num1=3.1415926; const num2=num1; //错误写法2}
常量不能更改
常量表达式里面的值不能允许有变 ...
Maven 基础教程什么是 MavenMaven 是一个项目管理工具，它包含了一个项目对象模型 (POM：Project Object Model)，一组标准集合，一个项目生命周期(Project Lifecycle)，一个依赖管理系统(Dependency Management System)，和用来运行定义在生命周期阶段(phase)中插件(plugin)目标(goal)的逻辑。
Maven 的核心概念项目对象模型 (POM)POM 是 Maven 工作的基础，它是一个 XML 文件，包含了项目的基本信息，用于描述项目如何构建，声明项目依赖等。
依赖管理Maven 提供了强大的依赖管理功能，可以自动下载项目所需的依赖库，并管理依赖的版本冲突。
构建生命周期Maven 定义了一套完整的构建生命周期，包括清理、编译、测试、打包、集成测试、验证、部署等阶段。
Maven 常用命令1234567891011121314# 编译项目mvn compile# 运行测试mvn test# 打包项目mvn package# 安装到本地仓库mvn install# 清理项目mvn clean
Ma ...
常用 Cursor 提示词模板总结通用任务模板角色设定：
你现在是资深工程师
核心要素：
背景：[简要背景/技术栈]
目标：[要达成的结果]
约束：[性能/安全/兼容/风格/依赖版本/时间复杂度/内存限制]
产出格式：[代码+说明/仅代码/步骤清单/表格]
作用范围：[文件或目录，如 src/、src/index.ts]
不要做：[不改动API签名/不引入新依赖/不修改业务逻辑]
验收标准：[测试通过/无 ESLint 报错/可运行示例]
Cursor 提示词模板 - 新增功能功能实现模板核心指令：
请在项目中实现功能：[功能描述]
关键要素：
修改文件：[列出具体文件路径，如 src/feature/x.ts、src/routes.ts]
输入输出：[明确函数签名/接口/数据结构]
边界场景：[列举需要考虑的边界情况]
需要的测试：[单测/集成测试等测试要求]
输出要求：完整可运行代码与必要说明
Cu ...
