IntelliJ导入Spring Boot骨架项目后运行、构建异常求助
Spring Boot项目在IntelliJ下构建失败、启动报百分号解码错误修复方案
两类报错的共通触发源:类路径URL存在JDK无法合法解码的百分号编码字符
- Maven install阶段,Surefire插件加载类路径时触发解码失败,中断构建流程,抛出
Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.22.2:test错误 - 调试启动阶段,IntelliJ注入的调试代理(javaagent)路径编码异常,触发类加载器解析错误,直接导致JVM原生层崩溃,输出
Error decoding percent encoded characters异常栈
修复操作步骤
- 校验全链路路径合法性
检查项目存放路径、Maven本地仓库路径、IntelliJ系统缓存路径的全段字符,确保不存在中文、空格、未转义的特殊字符(%、#、&等)。常见触发场景为项目存放在中文命名的桌面文件夹下,这类路径会被自动编码为带百分号的URL格式,部分特殊字符的编码规则不符合JDK解析标准,直接触发解码失败 - 清理本地异常配置与缓存
- 关闭当前项目,在IntelliJ欢迎页移除项目对应的本地运行配置(仅删除IDE侧配置,不改动项目源码)
- 执行
Invalidate Caches...全量清理IDE缓存,重启IDE
- 重新导入项目完成基础校验
- 以Maven源码模式重新导入项目根目录下的
pom.xml - 执行
mvn clean install -DskipTests验证跳过测试场景下的构建流程是否正常 - 单独执行
mvn test指令,验证Surefire插件报错是否消失
- 以Maven源码模式重新导入项目根目录下的
- 修正调试启动配置
- 打开主启动类对应的运行配置页,检查VM参数栏是否存在手写的非法路径
- 确认调试代理路径为系统自动生成的合法格式,无手动修改的异常编码字符
- 重新触发调试启动,验证JVM初始化流程是否正常
内容的提问来源于stack exchange,提问作者Aayush Srivastava
相关产品推荐
相关产品推荐

