MacOS桌面存储的Spring Boot项目构建失败原因排查

问题现象 #

将Spring Boot项目放在MacBook桌面的任意文件夹中执行mvn clean install时构建失败，所有测试类抛出java.lang.IllegalStateException: Unable to find a @SpringBootConfiguration错误；但将项目移动到桌面以外的目录时，构建可正常完成。

核心原因 #

桌面目录下的项目路径包含空格字符（比如示例中的IDEA Projects被转义为IDEA%20Projects），Spring的PathMatchingResourcePatternResolver在处理带空格的转义路径时出现异常，无法正确找到编译后的class文件，进而无法定位带有@SpringBootConfiguration的启动类，导致测试上下文初始化失败。

解决办法 #

• 直接迁移项目到无空格路径：将项目移动到桌面以外、路径中不含空格的目录（例如/Users/你的用户名/Code/），这是最简单有效的解决方案。
• 修改桌面文件夹名称：如果必须放在桌面，把包含空格的文件夹名（如IDEA Projects）修改为无空格的名称（如IDEAProjects），重新执行构建命令。
• 调整Maven Surefire插件配置（可选）：在项目的pom.xml中添加Surefire插件的配置，调整路径解析逻辑：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.2</version>
            <configuration>
                <useSystemClassLoader>false</useSystemClassLoader>
                <forkCount>0</forkCount>
            </configuration>
        </plugin>
    </plugins>
</build>

错误日志关键信息解析 #

日志中多次出现的java.nio.file.NoSuchFileException提示，本质是路径中的空格被转义为%20后，Spring资源解析器无法正确识别实际目录结构，找不到target/classes或target/test-classes下的类目录，最终导致测试类无法定位Spring Boot的配置类。

内容的提问来源于stack exchange，提问作者Nikita Shamrai