Spring应用读取Docker Compose环境变量失败，报jdbc URL格式错误

尝试将Spring应用与MySQL数据库建立连接时，始终收到错误提示："URL must start with 'jdbc'"。已在docker-compose.yml中配置含jdbc前缀的DATABASE_URL环境变量，并在application.properties中通过${DATABASE_URL}引用，但问题仍未解决。

报错信息 #

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'dataSource' defined in class path resource [org/springframework/boot/autoconfigure/jdbc/DataSourceConfiguration$Hikari.class]: Failed to instantiate [com.zaxxer.hikari.HikariDataSource]: Factory method 'dataSource' threw exception with message: URL must start with 'jdbc'

docker-compose.yml 配置 #

version: "3.8"

services:
  products-service:
    container_name: products-service
    build: .
    ports:
      - "8081:8081"
    environment:
      - DATABASE_URL=jdbc:mysql://products_db:3306/products_service?createDatabaseIfNotExist=TRUE&serverTimezone=UTC
      - DATABASE_USERNAME=root
      - DATABASE_PASSWORD=root
    depends_on:
      - products_db
    networks:
      - "products-network"
  products_db:
    container_name: products_db
    command: --default-authentication-plugin=mysql_native_password
    image: mysql:latest
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=products_service
networks:
  products-network:

application.properties 配置 #

application.name=products-service

server.port=8081

spring.datasource.url=${DATABASE_URL}
spring.datasource.username=${DATABASE_USERNAME}
spring.datasource.password=${DATABASE_PASSWORD}

spring.jpa.database-platform=org.hibernate.dialect.MySQLDialect
spring.jpa.hibernate.ddl-auto=update

eureka.client.service-url.defaultZone=http://localhost:8761/eureka
eureka.instance.lease-renewal-interval-in-seconds=0

排查与解决方法 #

• 确认环境变量传递有效性：执行docker exec products-service printenv DATABASE_URL命令，查看容器内实际的DATABASE_URL值，确认是否包含jdbc:前缀。若为空或值不符，说明环境变量未正确注入，需检查docker-compose配置或镜像构建流程。
• 修正URL转义字符：docker-compose.yml中URL的参数分隔符&无需转义为&，直接使用&即可。转义后的字符会被Spring解析为URL的一部分，可能引发参数解析异常。
• 检查配置覆盖情况：确认项目中是否存在其他配置文件（如分环境配置）或启动参数，覆盖了spring.datasource.url的值。若使用Spring Profiles，需确保激活的配置未重写该属性。
• 硬编码URL测试：临时将spring.datasource.url替换为完整的jdbc URL（不通过环境变量引用），若能正常连接，说明问题出在环境变量传递环节，需排查docker-compose或Dockerfile中的环境变量配置。

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