Spring Boot 启动提示数据源错误怎么办

在使用 Spring Boot 进行开发时，数据源配置是一个非常重要的环节。然而，由于配置不当或其他原因，Spring Boot 应用在启动时可能会提示数据源相关的错误。本文将详细介绍如何排查和解决这些常见的数据源错误。

1. 常见的数据源错误

在 Spring Boot 启动时，可能会遇到以下几种常见的数据源错误：

• Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.
• Cannot determine embedded database driver class for database type NONE
• Failed to bind properties under 'spring.datasource' to javax.sql.DataSource
• Failed to obtain JDBC Connection; nested exception is java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)

这些错误通常与数据源的配置有关，下面我们将逐一分析这些错误的原因及解决方法。

2. 错误原因分析及解决方法

2.1 Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

2.1.1 错误原因

这个错误通常是由于 Spring Boot 无法找到有效的数据源配置导致的。Spring Boot 默认会尝试配置一个嵌入式数据库（如 H2、HSQLDB），但如果你的项目中既没有配置嵌入式数据库，也没有配置外部数据库（如 MySQL、PostgreSQL），就会出现这个错误。

2.1.2 解决方法

1. 配置外部数据库：如果你使用的是外部数据库，确保在 application.properties 或 application.yml 中正确配置了数据源。例如：

   spring.datasource.url=jdbc:mysql://localhost:3306/mydb
   spring.datasource.username=root
   spring.datasource.password=password
   spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

1. 使用嵌入式数据库：如果你希望使用嵌入式数据库，可以在 pom.xml 中添加相应的依赖，例如 H2 数据库：

   <dependency>
       <groupId>com.h2database</groupId>
       <artifactId>h2</artifactId>
       <scope>runtime</scope>
   </dependency>

然后在 application.properties 中配置 H2 数据库：

   spring.datasource.url=jdbc:h2:mem:testdb
   spring.datasource.driverClassName=org.h2.Driver
   spring.datasource.username=sa
   spring.datasource.password=password
   spring.h2.console.enabled=true

1. 排除数据源自动配置：如果你的项目不需要数据库，可以通过排除数据源自动配置来避免这个错误。在启动类上添加 @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) 注解：

   @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
   public class MyApplication {
       public static void main(String[] args) {
           SpringApplication.run(MyApplication.class, args);
       }
   }

2.2 Cannot determine embedded database driver class for database type NONE

2.2.1 错误原因

这个错误通常是由于 Spring Boot 无法自动检测到嵌入式数据库的类型。如果你没有配置任何数据库，或者配置了不支持的数据库类型，就会出现这个错误。

2.2.2 解决方法

1. 配置嵌入式数据库：确保在 pom.xml 中添加了嵌入式数据库的依赖，例如 H2 数据库：

   <dependency>
       <groupId>com.h2database</groupId>
       <artifactId>h2</artifactId>
       <scope>runtime</scope>
   </dependency>

然后在 application.properties 中配置 H2 数据库：

   spring.datasource.url=jdbc:h2:mem:testdb
   spring.datasource.driverClassName=org.h2.Driver
   spring.datasource.username=sa
   spring.datasource.password=password
   spring.h2.console.enabled=true

1. 排除数据源自动配置：如果你的项目不需要数据库，可以通过排除数据源自动配置来避免这个错误。在启动类上添加 @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) 注解：

   @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
   public class MyApplication {
       public static void main(String[] args) {
           SpringApplication.run(MyApplication.class, args);
       }
   }

2.3 Failed to bind properties under 'spring.datasource' to javax.sql.DataSource

2.3.1 错误原因

这个错误通常是由于数据源配置不正确导致的。可能是 application.properties 或 application.yml 中的配置项拼写错误，或者配置项的值不符合要求。

2.3.2 解决方法

1. 检查配置项：确保 application.properties 或 application.yml 中的配置项拼写正确，并且值符合要求。例如：

   spring.datasource.url=jdbc:mysql://localhost:3306/mydb
   spring.datasource.username=root
   spring.datasource.password=password
   spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

1. 检查数据库连接：确保数据库服务正在运行，并且连接信息（如主机名、端口、用户名、密码）正确无误。

2. 检查数据库驱动：确保在 pom.xml 中添加了正确的数据库驱动依赖。例如，使用 MySQL 数据库时，需要添加以下依赖：

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

2.4 Failed to obtain JDBC Connection; nested exception is java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)

2.4.1 错误原因

这个错误通常是由于数据库连接的用户名或密码不正确导致的。可能是 application.properties 或 application.yml 中的用户名或密码配置错误，或者数据库中的用户权限设置不正确。

2.4.2 解决方法

1. 检查用户名和密码：确保 application.properties 或 application.yml 中的用户名和密码配置正确。例如：

   spring.datasource.username=root
   spring.datasource.password=password

1. 检查数据库用户权限：确保数据库中的用户具有足够的权限来访问指定的数据库。可以通过数据库管理工具（如 MySQL Workbench）或命令行工具来检查和修改用户权限。

2. 检查数据库连接：确保数据库服务正在运行，并且连接信息（如主机名、端口）正确无误。

3. 总结

Spring Boot 启动时提示数据源错误是一个常见的问题，通常与数据源的配置有关。通过仔细检查 application.properties 或 application.yml 中的配置项，确保数据库连接信息正确无误，并确保数据库服务正常运行，可以有效解决这些问题。如果项目不需要数据库，可以通过排除数据源自动配置来避免这些错误。

希望本文能够帮助你解决 Spring Boot 启动时遇到的数据源错误问题。如果你有其他问题或建议，欢迎在评论区留言讨论。