如何在Maven中创建自定义目录布局并解决类路径错误？

看起来你想要拆分测试代码的目录结构，但遇到了Maven类路径的典型坑——毕竟它对源码目录的默认规则卡得很严。别担心，咱们一步步把问题捋顺解决：

核心问题根源 #

Maven默认把src/test/java里的类归为测试范围代码，只有在test-compile阶段才会编译，而且主源码目录（比如你新增的文件夹如果被当成主源码）的classpath里根本不会包含这些测试类。所以当你在新增文件夹的代码里调用src/test/java的类时，编译阶段自然找不到对应的类文件。

正确解决方案：把新增文件夹纳入测试源码目录 #

既然你的新增文件夹是用来管理测试相关代码的，最规范的做法是让Maven把它们当成测试源码的一部分，这样就能和src/test/java的类共享classpath了。这里需要用到build-helper-maven-plugin来添加额外的测试源码目录：

1. 在pom.xml中添加插件配置 #

<build>
    <!-- 配置测试资源目录（如果新增文件夹有资源文件的话） -->
    <testResources>
        <testResource>
            <directory>src/test/resources</directory>
        </testResource>
        <!-- 替换成你第一个新增文件夹的资源路径（如果存在） -->
        <testResource>
            <directory>src/communication/resources</directory>
        </testResource>
        <!-- 第二个新增文件夹的资源路径（如果存在） -->
        <testResource>
            <directory>src/another-folder/resources</directory>
        </testResource>
    </testResources>

    <plugins>
        <!-- 使用build-helper插件添加额外测试源码 -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>3.3.0</version>
            <executions>
                <execution>
                    <id>add-test-sources</id>
                    <phase>generate-test-sources</phase>
                    <goals>
                        <goal>add-test-source</goal>
                    </goals>
                    <configuration>
                        <sources>
                            <!-- 替换成你的第一个新增文件夹路径 -->
                            <source>src/communication</source>
                            <!-- 第二个新增文件夹路径 -->
                            <source>src/another-folder</source>
                            <!-- 保留默认的测试源码目录 -->
                            <source>src/test/java</source>
                        </sources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 确保包结构与导入正确 #

比如src/test/java里的Login_AUT1类包名是com.yourproject.test，那communication文件夹里的Launcher类要对应包结构（比如src/communication/com/yourproject/communication/Launcher.java），然后在Launcher里正确导入：

import com.yourproject.test.Login_AUT1;

3. 验证编译和运行 #

配置完成后，执行mvn clean test，Maven会把所有测试源码（包括新增文件夹里的）一起编译，并且它们的classpath会包含所有测试类，这样Launcher就能正常找到Login_AUT1了。

为什么不推荐把新增文件夹当主源码？ #

如果硬要把新增文件夹设为主源码目录（src/main/java的同级），你需要把src/test/java的类打包成jar并作为依赖引入，但这违背了Maven的设计原则——测试类本来就是用于测试阶段的，不应该被主业务代码依赖，后续维护也会变得混乱。所以把新增文件夹纳入测试源码是最合理的选择。

内容的提问来源于stack exchange，提问作者aditya rawat