部署Spring Boot应用到Heroku时出现“Failed to configure a DataSource”错误

针对你遇到的Failed to configure a DataSource错误，以下是几个常见的排查和解决方向：

1. 确认MySQL驱动依赖是否正确配置 #

Spring Boot找不到驱动类，大概率是依赖缺失或范围配置错误。检查你的构建文件：

Maven（pom.xml） #

确保包含MySQL驱动依赖，且设置为runtime范围：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

Gradle（build.gradle） #

runtimeOnly 'mysql:mysql-connector-java'

如果依赖不存在，添加后重新部署；如果范围错误，调整为runtime（避免编译时依赖，让Spring在运行时自动识别）。

2. 检查application.yaml的配置细节 #

• 缩进验证：YAML对缩进极其敏感，确保datasource下的子属性（url、username等）都是缩进两个空格（和driver-class-name对齐），不要用tab混合空格。
• 移除显式驱动类配置：尝试删除driver-class-name: com.mysql.cj.jdbc.Driver这一行，Spring Boot可以根据url自动推断对应的驱动类，手动指定可能因版本不匹配导致问题。
• 端口适配Heroku：Heroku会动态分配端口，将server.port修改为：

  server:
    port: ${PORT:8081}
  

  这样本地运行用8081，Heroku上自动使用分配的端口。

3. 验证环境变量是否被正确加载 #

• Heroku Dyno环境：执行heroku run printenv命令，在输出中确认db_url、db_user、db_pass这三个变量是否存在且值正确。如果缺失，重新执行heroku config:set命令设置：

  heroku config:set db_url=jdbc:mysql://hostname:3306/db_name db_user=user db_pass=password
  

• heroku local运行：本地使用heroku local web时，需要在项目根目录创建.env文件，写入环境变量：

  db_url=jdbc:mysql://hostname:3306/db_name
  db_user=user
  db_pass=password
  

  否则heroku local无法读取到变量，会和Heroku上出现同样的错误。

4. 检查是否有Profile配置问题 #

错误提示提到“no profiles are currently active”，如果你的项目有多个配置文件（比如application-prod.yaml），需要在Heroku上激活对应的Profile：
执行以下命令设置激活的Profile：

heroku config:set SPRING_PROFILES_ACTIVE=prod

确保对应Profile的数据源配置正确。

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