使用Docker运行Quarkus 2.7.6+H2应用时数据源配置异常求助

核心问题定位 #

本地dev模式正常，但Docker环境下提示默认数据源未找到，说明问题出在Docker环境下的配置加载或资源访问差异上。

1. 检查Docker镜像中application.properties是否正确打包 #

• 确认构建镜像时，配置文件是否被复制到镜像的正确路径（Quarkus默认读取target/classes下的配置），进入容器执行命令查看：

  docker exec -it <容器ID> cat /work/application.properties
  

• 若配置文件缺失或内容错误，检查Dockerfile中的COPY指令是否完整复制了target/quarkus-app目录。

2. 验证H2数据库依赖在Docker镜像中是否存在 #

• 本地dev模式会自动管理依赖，但Docker镜像可能存在依赖缺失情况，进入容器查看：

  docker exec -it <容器ID> ls /work/lib | grep h2
  

• 若未找到h2相关jar包，确认构建命令是否执行了mvn package -Dquarkus.package.type=uber-jar（或对应Gradle命令），确保依赖被完整打包进镜像。

3. 排查数据库初始化脚本的路径问题 #

• 即使移除了初始化脚本部分，仍需确认Docker环境下资源路径是否正常：
  • 检查镜像中是否存在脚本文件：docker exec -it <容器ID> find /work -name carga_banco_dados.sql
  • 若脚本缺失，确认构建时src/main/resources/scripts目录是否被正确打包到target/classes，Dockerfile是否复制了这部分资源。

4. 检查Docker环境的配置加载优先级 #

• Quarkus会优先使用环境变量覆盖配置文件，检查Docker启动时是否有冲突的环境变量：
  • 执行docker exec -it <容器ID> env | grep quarkus.datasource，查看是否存在意外的配置覆盖。
  • 若有异常环境变量，检查run.sh脚本或Docker启动命令是否传入了相关参数。

5. 验证Quarkus的运行模式差异 #

• Quarkus prod模式与dev模式的配置加载逻辑不同，确认Docker环境是否以prod模式启动：
  • 可临时在启动命令中添加-Dquarkus.profile=dev测试，若能正常运行，说明是prod模式下的配置适配问题。

6. 查看详细启动日志定位问题 #

• 启用DEBUG/TRACE级别日志，查看配置加载的完整过程：

  ./run/run.sh -dc -Dquarkus.log.level=DEBUG -Dquarkus.log.category."io.quarkus.datasource".level=TRACE
  

• 从日志中可以追踪数据源配置的读取、解析过程，定位是配置未被读取还是读取后未生效。

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