构建与依赖 / 系统课时
主资源与测试资源目录
主资源与测试资源目录
Maven 默认把正式运行需要的资源放在 src/main/resources,把只供测试使用的资源放在 src/test/resources。理解两类目录的复制时机和目标位置后,就能判断配置文件为什么能被应用或测试读取,并快速定位资源没有进入 classpath 的问题。
学习目标
- 说清
src/main/resources与src/test/resources的职责和默认输出目录。 - 用 Maven 生命周期命令验证资源是否被复制,并检查复制后的相对路径。
- 知道何时需要自定义
<resources>或<testResources>,以及修改后的验证方法。
默认目录与输出位置
标准 Maven 项目不写资源配置时,会使用两套约定:src/main/resources 中的文件在 process-resources 阶段复制到 target/classes,src/test/resources 中的文件在 process-test-resources 阶段复制到 target/test-classes。目录内部的相对路径保持不变,例如 src/main/resources/config/app.properties 会变成 target/classes/config/app.properties。
| 源目录 | 默认生命周期阶段 | 默认输出目录 | 典型内容 |
|---|---|---|---|
src/main/resources |
process-resources |
target/classes |
应用配置、模板、静态字典 |
src/test/resources |
process-test-resources |
target/test-classes |
测试数据、测试专用配置、样例文件 |
默认资源复制不会把 src/test/resources 混入正式程序使用的 target/classes。因此,生产代码若只能依赖 src/test/resources 中的文件,通常说明资源位置或代码职责划分有误。
用生命周期命令验证复制
下面的命令应在一个已有 pom.xml 的 Maven 项目根目录执行。它创建两份资源,然后让 Maven 依次处理主资源和测试资源,最后直接读取目标目录中的文件。
test -f pom.xml || { echo 'missing pom.xml'; exit 1; }
mkdir -p src/main/resources/config src/test/resources/fixtures
echo 'app.name=demo' > src/main/resources/config/app.properties
echo 'fixture=local' > src/test/resources/fixtures/data.properties
mvn -q process-resources
mvn -q process-test-resources
cat target/classes/config/app.properties
cat target/test-classes/fixtures/data.properties预期输出:
app.name=demo
fixture=local如果第一条 cat 失败,先检查文件是否真的位于 src/main/resources;如果第二条失败,则确认执行的是 process-test-resources,而不是只执行了 process-resources。执行 mvn test 时也会经过这些资源处理阶段,因此测试开始前两套资源通常已经准备好。
自定义目录时要显式声明
项目如果必须沿用旧目录,例如正式资源放在 config/main、测试资源放在 config/test,可以在 pom.xml 中覆盖默认约定。以下是片段示例,依赖上下文为现有 Maven 项目的 <build> 节点。
<build>
<resources>
<resource>
<directory>config/main</directory>
</resource>
</resources>
<testResources>
<testResource>
<directory>config/test</directory>
</testResource>
</testResources>
</build>生效后,config/main 会复制到 target/classes,config/test 会复制到 target/test-classes。可放入两个标记文件进行完整验证:
mkdir -p config/main config/test
echo 'main.marker=ok' > config/main/main.properties
echo 'test.marker=ok' > config/test/test.properties
mvn -q clean process-test-resources
cat target/classes/main.properties
cat target/test-classes/test.properties预期输出:
main.marker=ok
test.marker=ok显式配置资源集合后,不要假定 Maven 仍会替你追加原来的默认目录。若项目既要保留 src/main/resources,又要增加第二个正式资源目录,应在 <resources> 中把需要参与构建的资源项全部明确列出,并通过 target/classes 中的实际文件验收。