SpringBoot 3.1.0数据源配置失败：未指定url属性，求解决方案？

问题场景 #

我有一个基于SpringBoot 3.1.0的项目，依赖配置如下：

id "org.springframework.boot" version "3.1.0"
implementation "org.springframework.boot:spring-boot-starter-data-couchbase"
implementation platform("org.springframework.cloud:spring-cloud-dependencies:2022.0.2")
implementation 'org.springframework.boot:spring-boot-starter-data-jpa:3.1.0'

仅在application.yml中配置了Couchbase连接（未填充具体地址）：

spring:
  couchbase:
    connection-string:

启动项目时触发错误：

Description:

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

Reason: Failed to determine a suitable driver class


Action:

    Consider the following:
        If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.
        If you have database settings to be loaded from a particular profile you may need to activate it (the profiles local are currently active).

解决方案 #

方案1：移除不必要的JPA依赖 #

如果项目仅需Couchbase作为数据存储，不需要通过JPA操作关系型数据库，直接移除spring-boot-starter-data-jpa依赖即可。SpringBoot不会再自动触发JPA数据源配置，错误会消失。

修改后的依赖配置：

id "org.springframework.boot" version "3.1.0"
implementation "org.springframework.boot:spring-boot-starter-data-couchbase"
implementation platform("org.springframework.cloud:spring-cloud-dependencies:2022.0.2")

方案2：补充JPA数据源配置（需同时使用Couchbase和JPA） #

如果确实需要同时集成Couchbase和JPA，必须完整配置JPA的数据源信息：

1. 在application.yml中添加JPA数据源配置（以MySQL为例），同时补全Couchbase的连接信息：

spring:
  couchbase:
    connection-string: couchbase://你的Couchbase地址
    username: Couchbase用户名
    password: Couchbase密码
  datasource:
    url: jdbc:mysql://localhost:3306/你的数据库名
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: 数据库用户名
    password: 数据库密码
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

2. 确保添加对应数据库的驱动依赖（比如MySQL驱动）：

implementation 'mysql:mysql-connector-java:8.0.33'

方案3：使用嵌入式数据库（仅开发测试场景） #

如果只是开发测试需要JPA功能，可添加嵌入式数据库依赖（如H2），SpringBoot会自动配置嵌入式数据源：

implementation 'com.h2database:h2'

可选补充H2控制台配置，方便开发时查看数据：

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:
  h2:
    console:
      enabled: true

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