You need to enable JavaScript to run this app. IntelliJ导入Spring Boot骨架项目后运行、构建异常求助
优惠活动
大模型
产品
解决方案
定价
更多

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解析标准,直接触发解码失败
  • 清理本地异常配置与缓存
    1. 关闭当前项目,在IntelliJ欢迎页移除项目对应的本地运行配置(仅删除IDE侧配置,不改动项目源码)
    2. 执行Invalidate Caches...全量清理IDE缓存,重启IDE
  • 重新导入项目完成基础校验
    1. 以Maven源码模式重新导入项目根目录下的pom.xml
    2. 执行mvn clean install -DskipTests验证跳过测试场景下的构建流程是否正常
    3. 单独执行mvn test指令,验证Surefire插件报错是否消失
  • 修正调试启动配置
    1. 打开主启动类对应的运行配置页,检查VM参数栏是否存在手写的非法路径
    2. 确认调试代理路径为系统自动生成的合法格式,无手动修改的异常编码字符
    3. 重新触发调试启动,验证JVM初始化流程是否正常

内容的提问来源于stack exchange,提问作者Aayush Srivastava

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 11:36:05