Micronaut YAML配置默认值含特殊字符致JDBC URL解析异常

核心问题 #

在Micronaut的application.yml中配置额外数据源的URL时，使用如下写法会导致系统从最后一个冒号截断JDBC URL：

url: ${DATASOURCE_URL:jdbc:postgresql://localhost:5432/postgres}

抛出错误：

Message: Invalid JDBC URL [5432/postgres]. JDBC URLs must start with 'jdbc'.

尝试过单引号、双引号及反斜杠转义均无效，同时需满足：

• 未定义DATASOURCE_URL时，测试环境需空值触发Micronaut Test Resources自动创建数据源
• 多数据源场景下无法省略额外数据源的URL配置

解决方案 #

1. 正确转义占位符默认值（解决截断问题） #

将整个占位符表达式用单引号包裹，避免YAML和Micronaut解析器错误拆分默认值中的冒号：

url: '${DATASOURCE_URL:jdbc:postgresql://localhost:5432/postgres}'

单引号会让YAML将整个占位符字符串视为单一值，Micronaut解析时会完整识别默认的JDBC URL，不会出现截断。

2. 测试环境单独配置空值（触发Test Resources） #

创建application-test.yml文件，激活test profile时覆盖额外数据源的URL配置，确保未定义DATASOURCE_URL时为空值：

datasources:
  # 替换为你的额外数据源名称
  extra-db:
    url: '${DATASOURCE_URL:}'

这样在测试环境中，当DATASOURCE_URL未设置时，URL为空，Micronaut Test Resources会自动创建测试用数据源；生产/开发环境则使用application.yml中的默认JDBC URL。

验证效果 #

• 生产/开发环境：未设置DATASOURCE_URL时，系统会使用默认的jdbc:postgresql://localhost:5432/postgres作为数据源URL
• 测试环境：未设置DATASOURCE_URL时，URL为空，Test Resources自动配置测试数据源；若设置了DATASOURCE_URL，则使用该值

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