Quarkus测试阶段DevServices卷映射变量未注入，容器启动失败求助

原因分析 #

从错误日志可见，${INIT_SQL_SCRIPTS_PATH} 并未被替换为实际路径，而是原样保留在Docker卷映射参数中。这是因为Quarkus DevServices的配置变量替换逻辑，与Maven属性传递的时机、方式不匹配导致的。

具体解决办法 #

1. 开启Maven资源过滤，让配置文件在构建时完成变量替换 #

默认情况下Maven不会自动替换YAML配置文件中的${}变量，需要在pom.xml中开启资源过滤：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>application.yml</include>
            </includes>
        </resource>
        <resource>
            <directory>src/test/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>application.yml</include>
            </includes>
        </resource>
    </resources>
</build>

开启后，Maven会在构建阶段将配置文件中的${INIT_SQL_SCRIPTS_PATH}替换为对应Profile或环境中的属性值，确保传递给Quarkus的是实际路径。

2. 改用Quarkus原生环境变量读取逻辑 #

如果依赖Jenkins环境变量或系统环境变量，可直接让Quarkus读取环境变量，跳过Maven属性传递：
修改application.yml配置：

datasource:
    devservices:
        enabled: true
        volumes:
            "${env:INIT_SQL_SCRIPTS_PATH}": /container-entrypoint-initdb.d

这种方式下，Quarkus会直接从运行环境中读取INIT_SQL_SCRIPTS_PATH变量值，无需依赖Maven的替换逻辑。

3. 修正Windows路径格式 #

Windows路径中的反斜杠\容易导致Docker解析错误，需统一调整为正斜杠：

• 若使用Maven Profile定义路径，修改为：

  <profile>
      <id>windows</id>
      <activation>
          <os>
              <family>windows</family>
          </os>
      </activation>
      <properties>
          <INIT_SQL_SCRIPTS_PATH>C:/my_app/sql_scripts</INIT_SQL_SCRIPTS_PATH>
      </properties>
  </profile>
  

• 若使用环境变量，直接设置路径为正斜杠格式即可。

4. 验证变量替换结果 #

执行mvn process-resources命令，查看target/classes/application.yml（或target/test-classes/application.yml）中的内容，确认${INIT_SQL_SCRIPTS_PATH}已被替换为实际路径后，再启动测试。

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