1. Trae 里跑 Spring Boot 总报 JDK 找不到问题多半出在 settings.json刚接触 Trae 的 Java 开发者最容易卡在同一个地方项目能打开代码能高亮但一按运行就提示找不到 JDK或者 Maven 依赖死活拉不下来。我见过太多人第一反应是重装 JDK其实真正的原因往往藏在 Trae 的settings.json里——这个文件决定了编辑器用哪个 Java 运行时、哪个 Maven、去哪读settings.xml。Trae 是基于 VS Code 内核的 AI 编辑器它的 Java 支持来自 Language ServerJDT LS和 Maven 插件。这两套东西各自读配置路径写错一个字符表现就是「编译能过、运行报错」或者「依赖树一片红」。所以这篇不讲虚的直接把settings.json里 JDK、Maven 路径、依赖解析这几块逐条拆开给你能直接复制的片段再走一遍新建 Spring Boot 项目后验证编译、拉依赖、启动的完整流程。适合谁看刚装好 Trae、准备写第一个 Spring Boot 接口的 Java 开发者或者从 IDEA 转过来、发现 Maven 路径对不上的朋友。核心检索词就三个——Trae、Spring Boot 运行环境、settings.json 与 Maven 配置下面全部围绕它们展开。先说清楚一个前提Trae 的 Java 配置分两层。一层是用户级 settings.json全局生效一层是项目级.vscode/settings.json只对当前项目生效。新手最容易混改了半天发现没生效其实是改错了文件。我的建议是JDK 和 Maven 的绝对路径放用户级项目特有的编译参数放项目级。下面第 2 节先讲清楚这个文件到底在哪、怎么打开。2. 找到 Trae 的 settings.json 并配好 JDK 与 Maven 路径2.1 settings.json 到底在哪Trae 的用户级配置文件路径跟 VS Code 类似Windows 下一般在C:\Users\你的用户名\.trae\settings.json如果你是通过插件模板生成的也可能出现在扩展目录里比如C:\Users\用户账号\.trae\extensions\vscjava.vscode-java-dependency-0.26.3-universal\templates\invisible-project\.vscode\settings.json这个模板文件是新建 Java 项目时的初始配置来源直接替换它的内容后续新建项目就会带上你的路径。但要注意模板文件和你当前工作区的配置是两回事改完模板记得也检查一下当前项目的.vscode/settings.json。打开方式有两种。第一种走菜单顶部File → Preferences → Settings中文界面是文件 → 首选项 → 设置右上角有个「打开设置(JSON)」的小图标点它就能编辑原始 JSON。第二种更直接CtrlShiftP打开命令面板输入Preferences: Open User Settings (JSON)回车。2.2 JDK 配置runtimes 和 jdt.ls.java.home 别搞混JDK 这块有两个关键项很多人只配了一个结果 Language Server 起不来。{ java.configuration.runtimes: [ { name: JavaSE-17, path: E:\\develop\\java17, default: true } ], java.jdt.ls.java.home: E:\\develop\\java17 }java.configuration.runtimes是告诉 Trae「我机器上有哪些 JDK 可用」default: true表示默认用这个。java.jdt.ls.java.home是专门给 Java Language Server 用的插件要求它至少是 JDK 17。这两个路径可以指向同一个 JDK也可以分开——比如你项目跑 JDK 8但 Language Server 用 JDK 17那就分别写。路径里的反斜杠要写成双反斜杠\\这是 JSON 的转义要求写成单斜杠会解析失败。这是新手第一个高频坑。2.3 Maven 配置四个路径项一次配齐Maven 相关的配置项比较多容易漏。下面这段是完整版{ java.configuration.maven.globalSettings: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, java.configuration.maven.userSettings: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, maven.executable.path: E:\\develop\\maven_zj\\apache-maven-3.8.2\\bin\\mvn.cmd, maven.settingsFile: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, java.configuration.maven.defaultMaven.version: 3.9.9 }逐条解释maven.executable.path指向bin\mvn.cmd这是让 Trae 用你自己装的 Maven而不是内置的。Windows 下必须写mvn.cmd写mvn会找不到。maven.settingsFile和java.configuration.maven.userSettings都指向你的settings.xml前者给 Maven 插件用后者给 Java 插件用两个都填上最稳。java.configuration.maven.globalSettings是全局 settings如果你公司有私服配置通常写在这里。defaultMaven.version写你实际用的版本号写错会导致依赖解析行为不一致。2.4 顺手把这几项也加上{ java.compile.nullAnalysis.mode: automatic, java.configuration.updateBuildConfiguration: automatic, java.debug.settings.hotCodeReplace: auto, java.dependency.packagePresentation: hierarchical, workbench.settings.applyToAllProfiles: [ java.configuration.maven.globalSettings, java.configuration.maven.userSettings ], files.encoding: utf8, files.eol: \n, editor.formatOnSave: true, editor.codeActionsOnSave: { source.organizeImports: true }, java.debug.settings.console: integratedTerminal, java.test.defaultConfig: JavaSE-17 }updateBuildConfiguration: automatic让 Trae 在pom.xml变动后自动重新解析依赖省得手动刷新。hotCodeReplace: auto开启热替换改方法体不用重启。applyToAllProfiles保证多配置文件下 Maven 路径一致。files.eol: \n避免 Windows 换行符在 Git 里产生噪音。3. 可复制的完整 settings.json 与 Maven 关键项对照3.1 一份能直接用的完整配置把下面这段整体替换你的用户级settings.json路径改成你自己的即可{ java.configuration.runtimes: [ { name: JavaSE-17, path: E:\\develop\\java17, default: true } ], java.jdt.ls.java.home: E:\\develop\\java17, java.configuration.maven.globalSettings: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, java.configuration.maven.userSettings: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, maven.executable.path: E:\\develop\\maven_zj\\apache-maven-3.8.2\\bin\\mvn.cmd, maven.settingsFile: E:\\develop\\maven_zj\\apache-maven-3.8.2\\conf\\settings.xml, java.configuration.maven.defaultMaven.version: 3.9.9, java.compile.nullAnalysis.mode: automatic, java.configuration.updateBuildConfiguration: automatic, java.debug.settings.hotCodeReplace: auto, java.dependency.packagePresentation: hierarchical, workbench.settings.applyToAllProfiles: [ java.configuration.maven.globalSettings, java.configuration.maven.userSettings ], files.encoding: utf8, files.eol: \n, editor.formatOnSave: true, editor.codeActionsOnSave: { source.organizeImports: true }, java.debug.settings.console: integratedTerminal, java.test.defaultConfig: JavaSE-17 }3.2 图形界面里对应的几个开关不想全用 JSON 的可以在设置界面搜索框里操作。搜maven executable会看到Maven › Executable: Path点右侧浏览图标选到bin\mvn.cmd。同一页把Maven › Executable: Prefer Maven Wrapper取消勾选设成false——这一步很关键否则项目里带mvnw时Trae 会优先用 wrapper把你配的 Maven 路径带跑偏。再搜maven settings会出现两项Maven › Settings: File和Java › Maven: Global Settings两个都点浏览选同一个settings.xml文件。3.3 Maven 关键项对照表配置项作用典型值maven.executable.path指定 mvn 可执行文件...\bin\mvn.cmdmaven.settingsFileMaven 插件读的 settings...\conf\settings.xmljava.configuration.maven.userSettingsJava 插件读的 settings同上java.configuration.maven.globalSettings全局 settings同上或私服配置defaultMaven.version声明 Maven 版本3.9.9Prefer Maven Wrapper是否优先用 mvnwfalse3.4 别忘了 settings.xml 里的镜像Trae 的配置只管「用哪个 Maven」真正决定依赖从哪拉的是settings.xml里的 mirror。国内环境建议配阿里云镜像mirrors mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrorsmirrorOf写*表示所有仓库请求都走这个镜像。配完保存Trae 会自动重新解析。4. 新建 Spring Boot 项目后验证编译、拉依赖与启动4.1 打开项目并触发依赖解析文件 打开文件夹选中你的 Spring Boot 项目根目录有pom.xml那一层。打开后 Trae 右下角会弹出「正在导入 Maven 项目」等它跑完。如果没自动触发CtrlShiftP输入Java: Clean Java Language Server Workspace重启一次。依赖拉取成功的标志左侧「Java 项目」视图里Maven Dependencies下面能看到一堆 jar 包没有红色波浪线。4.2 命令行验证 Maven 是否走对了在 Trae 内置终端Ctrl里执行mvn -v输出应该显示你配置的 Maven 版本和 JDK 版本。如果显示的是内置版本说明maven.executable.path没生效回去检查路径。再跑一次依赖解析mvn dependency:resolve看到BUILD SUCCESS就说明依赖全部拉下来了。4.3 编译并启动mvn clean compile编译通过后直接运行主类。找到XxxApplication.java类名上方会有Run按钮点它。或者在终端mvn spring-boot:run启动成功的标志是控制台出现Started XxxApplication in x.xxx seconds并且 Tomcat 端口默认 8080监听正常。浏览器访问http://localhost:8080能看到 Whitelabel 页面或你的接口返回就说明整个运行环境通了。4.4 写个接口实测一下在src/main/java下建个 ControllerRestController public class HelloController { GetMapping(/hello) public String hello() { return trae springboot ok; } }重启后访问http://localhost:8080/hello返回trae springboot ok环境就算彻底跑通了。5. 常见报错逐条排查401、local proxy failed、reading choices5.1 报错「找不到 JDK」或 Language Server 启动失败典型提示The Java Language Server requires JDK 17 or above。原因通常是java.jdt.ls.java.home没配或指向了低版本 JDK。检查这个路径是否真实存在且bin\java.exe能执行。命令行验证E:\develop\java17\bin\java -version5.2 报错「local proxy failed」或依赖下载超时这个多半是settings.xml的镜像没配好或者公司网络需要走内部私服。先确认maven.settingsFile指向的文件里 mirror 配置正确。如果提示local proxy failed检查是不是在settings.xml里写了不可用的代理节点把proxies段清空再试。5.3 报错「reading choices」或依赖树解析异常这种一般是pom.xml里有依赖版本冲突或者本地仓库有损坏的 jar。清理本地仓库对应目录后重拉mvn dependency:purge-local-repository mvn clean install -U-U强制更新快照依赖。5.4 报错 401 Unauthorized如果依赖来自需要认证的私服settings.xml里要配serversservers server idyour-repo-id/id username你的账号/username password你的密码/password /server /serversid必须和pom.xml里 repository 的id一致否则认证不生效。5.5 报错 OAuth 或登录态失效如果你在 Trae 里接入了需要鉴权的模型服务出现 OAuth 相关报错通常是 token 过期。重新走一遍授权流程即可。这类问题跟 Spring Boot 本身无关但会干扰你判断环境是否配好建议先把 Java 环境跑通再处理。5.6 改了配置不生效最常见的原因是改错了文件层级。用户级配置在C:\Users\你的用户名\.trae\settings.json项目级在项目根目录.vscode\settings.json。项目级优先级更高如果项目级里也写了 Maven 路径会覆盖用户级。排查时两个都打开看一眼。6. 环境配好之后把模型能力接进你的开发流Spring Boot 环境跑通只是第一步。实际开发里写接口、补测试、排查异常这些环节如果有个顺手的模型服务能调用效率会明显不一样。TaoToken 提供的就是这类能力通过统一的 API 接入多种模型不用自己折腾多套鉴权。如果你主要做长期编码和 Agent 类任务可以看看 Coding Plan适合把模型能力嵌进日常开发流程https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan需要先拿 Key 的去控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleAPI Key 管理页在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入文档写得很细Base URL、Key、Model ID 三件套怎么填都有说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc想先在网页上试试模型对话效果的直接开这个https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chatAPI 的基础地址是https://taotoken.net/api配置时注意不要多加路径后缀。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthome最后提醒一句Trae 的settings.json改完记得保存并重启 Language ServerMaven 路径和 JDK 路径都用绝对路径、双反斜杠。这两点做到Spring Boot 运行环境基本不会出幺蛾子。