Apache DolphinScheduler 独立部署模式下环境变量配置的注意事项

在使用 Docker 部署 Apache DolphinScheduler 独立服务器（Standalone Server）时，环境变量的配置方式会直接影响数据库连接行为。本文深入分析一个典型配置问题及其解决方案。

问题现象

当用户通过以下命令启动容器时：

docker run -it --env-file .env apache/dolphinscheduler-standalone-server

其中 .env 文件内容为：

DATABASE=postgresql
SPRING_DATASOURCE_URL=jdbc:postgresql://10.1.3.203:5432/dolphinscheduler
SPRING_DATASOURCE_USERNAME=dolphinscheduler
SPRING_DATASOURCE_PASSWORD=dolphinscheduler

系统却报出 H2 数据库驱动不兼容 PostgreSQL JDBC URL 的错误。日志显示当前激活的 profile 仍然是 h2，但数据源参数已被环境变量覆盖。

技术原理

这种现象源于 Spring Boot 的配置加载机制：

1. Profile 激活机制：默认情况下 Standalone Server 使用 h2 profile，这会加载 H2 数据库的默认配置
2. 环境变量优先级：Spring Boot 中环境变量具有较高优先级，会覆盖配置文件中的对应值
3. 不完整覆盖：虽然数据源参数被环境变量覆盖，但驱动类等关联配置仍保持 profile 的原始设置

正确配置方案

要实现完整的 PostgreSQL 配置，需要同时设置两个关键环境变量：

SPRING_PROFILES_ACTIVE=postgresql
DATABASE=postgresql

这种配置方式可以确保：

1. 激活正确的 profile 配置组
2. 加载 PostgreSQL 专用的驱动类和相关参数
3. 保持环境变量对连接信息的覆盖能力

生产环境建议

对于需要持久化数据的生产环境，建议：

1. 始终明确指定 SPRING_PROFILES_ACTIVE
2. 通过 volume 挂载持久化存储
3. 考虑使用外部数据库而非嵌入式 H2
4. 完整的 PostgreSQL 配置示例：

SPRING_PROFILES_ACTIVE=postgresql
SPRING_DATASOURCE_URL=jdbc:postgresql://host:port/db
SPRING_DATASOURCE_USERNAME=user
SPRING_DATASOURCE_PASSWORD=pass
SPRING_JACKSON_TIME_ZONE=UTC

总结

理解 Spring Boot 的配置加载顺序和 profile 机制对于正确部署 DolphinScheduler 至关重要。在容器化部署时，务必确保 profile 激活状态与预期的数据库类型一致，避免出现配置片段被部分覆盖的情况。对于需要持久化数据的场景，建议始终使用外部数据库并明确指定所有相关配置参数。