You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot 3.3.2启动报错排查:找不到主类/NoClassDefFoundError求助

问题原因分析

Spring Boot 3.3.x版本调整了Maven构建环节的路径处理逻辑,其中spring-boot-maven-plugin插件对包含非ASCII字符(比如你的俄文用户名)的路径存在编码兼容问题。在Windows系统中,用户目录是Maven本地仓库和项目路径的默认位置之一,当路径包含俄文这类Unicode字符时,3.3.x版本的插件无法正确解析或拼接类路径,导致类加载器找不到主类com.example.demo.DemoApplication,或是无法加载Spring Boot核心依赖类org.springframework.boot.SpringApplication。而3.2.x版本未做该逻辑调整,因此可以正常运行。

解决办法
  • 临时降级版本:继续使用Spring Boot 3.2.8版本,直到官方修复该路径兼容问题。
  • 修改Maven本地仓库路径:编辑Maven的settings.xml文件(路径为%USERPROFILE%/.m2/settings.xml,不存在则新建),将本地仓库指定到不含非ASCII字符的目录,示例配置:
    <settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
      <localRepository>C:\maven-local-repo</localRepository>
    </settings>
    
  • 迁移项目路径:把项目移动到不含非英文字符的目录下,比如C:\spring-projects\demo,避免路径中出现俄文等Unicode字符。
  • 等待官方修复:该问题属于版本特定的兼容性bug,Spring Boot官方通常会在后续3.3.x的小版本更新中修复,可关注官方版本发布日志,待修复完成后再升级回3.3.x系列版本。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.20 05:28:16