Spring Boot拉取Git项目后MySQL数据源配置失败求助

1. 核对配置文件的路径与命名 #

Spring Boot默认读取src/main/resources下的application.yml（或.properties）文件，先确认笔记本端项目：

• 配置文件是否在正确的resources目录内，没有被误移到其他文件夹
• 文件名拼写无误，比如原项目用application.yml就不要写成application.yaml，如果用了多环境配置（如application-dev.yml），要确保激活对应环境

2. 检查多环境Profile激活状态 #

如果原项目依赖特定环境配置：

• 查看IDE启动配置的VM参数，确认是否添加了-Dspring.profiles.active=dev（对应你的环境标识）
• 或者检查主配置文件application.yml里是否指定了spring.profiles.active: dev
• 也可以排查系统/项目的环境变量，确认有没有设置对应的Profile参数

3. 排查Git忽略规则 #

打开项目根目录的.gitignore文件，确认是否把配置文件（比如application.yml）加入了忽略列表——这会导致笔记本拉取的项目里没有实际配置内容。解决方式：

• 若配置不含敏感信息，从.gitignore中移除对应规则后重新提交拉取
• 若配置有敏感信息，在笔记本本地手动创建配置文件，填入正确的数据源配置：

  spring:
    datasource:
      url: jdbc:mysql://localhost:3306/your_db?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
      username: your_user
      password: your_pwd
      driver-class-name: com.mysql.cj.jdbc.Driver
  

4. 确认依赖完整性 #

有时候拉取项目后依赖未完全下载，导致MySQL驱动缺失：

• Maven项目执行mvn clean install，Gradle项目执行gradle clean build重新拉取依赖
• 检查pom.xml（或build.gradle）是否包含MySQL驱动依赖：

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

  // Gradle
  runtimeOnly 'mysql:mysql-connector-java:8.0.33'
  

5. 检查配置文件语法 #

YAML对缩进和格式要求严格，确认笔记本端配置：

• 用空格缩进（不要用Tab），层级对齐正确
• 键值对冒号后必须加空格（比如spring: datasource是错误写法，应为spring: datasource）
• 字符串没有多余的引号或转义错误

6. 验证配置加载情况 #

添加测试类打印配置，确认配置是否生效：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class ConfigChecker implements CommandLineRunner {

    @Value("${spring.datasource.url:配置未加载}")
    private String dbUrl;

    @Override
    public void run(String... args) {
        System.out.println("当前数据库URL：" + dbUrl);
    }
}

启动项目后看控制台输出，若显示“配置未加载”，说明配置文件确实未被读取，回到前面步骤重新排查。

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