
> **一句话复盘**：引入了 `mybatis-spring-boot-starter`，却忘了配数据库——Spring Boot 的自动装配机制当场“罢工”。

---

##  一、事故现场

今天新建一个 Spring Boot 项目，打算用 MyBatis 操作 MySQL。刚写完 `pom.xml` 和一个空的 Mapper 接口，兴致勃勃点击启动，结果控制台直接红屏：

```log
***************************
APPLICATION FAILED TO START
***************************

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
```

我一脸懵：**我还没写业务代码呢，怎么就报数据源错了？**

---

## 🔍 二、问题根源分析

### ❓ 为什么没配数据库也会报错？

关键在于依赖！我的 `pom.xml` 中有这一行：

```xml
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>
```

而 `mybatis-spring-boot-starter` **内部传递依赖了 `spring-boot-starter-jdbc`**，后者会触发 Spring Boot 的 `DataSourceAutoConfiguration` 自动配置。

> ✅ **自动配置逻辑**：
> - 检查 `spring.datasource.url` 是否存在？
> - 不存在 → 查看 classpath 是否有 H2/HSQLDB 等嵌入式数据库？
> - 都没有 → 抛出异常！

**我既没配 URL，也没加 H2，自然启动失败。**

---

## 🛠️ 三、解决方案（亲测有效）

### ✅ 方案 1：我真的要用 MySQL（推荐）

#### 步骤 1：添加数据库驱动
```xml
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>
```

#### 步骤 2：配置 `application.yml`
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
```

> ⚠️ **避坑提示**：
> - 不要写成 `jdbc-url`（这是旧版属性）
> - YAML 缩进必须是 **2 空格**，不能用 Tab！

---

### ✅ 方案 2：我只是先搭框架，暂时不用 DB

那就**禁止 Spring Boot 自动配置数据源**：

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

> 💡 这样即使引入了 MyBatis starter，也不会强制要求数据源。

---

### ✅ 方案 3：临时用内存数据库（适合单元测试）

加个 H2 依赖，什么都不用配：

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

Spring Boot 会自动创建一个内存数据库，项目顺利启动！

---

## 📌 四、经验总结

| 场景 | 建议 |
|------|------|
| **正式开发** | 老老实实配好 MySQL/PostgreSQL |
| **快速原型** | 用 H2 嵌入式数据库 |
| **纯 API 服务** | 直接 `exclude = DataSourceAutoConfiguration` |
| **多模块项目** | 检查是否在 common 模块误引了 MyBatis |

> 🔥 **核心认知**：  
> **Spring Boot 的“自动”是有前提的——你得给它足够的信息，否则它宁可报错也不瞎猜。**

---

## 🚀 五、附：完整可运行配置（Spring Boot 3.x + MyBatis）

**pom.xml**
```xml
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>3.0.3</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>
```

**application.yml**
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test?useSSL=false&allowPublicKeyRetrieval=true
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.example.demo.entity
```

---

> 💬 **互动**：你也遇到过这个“经典开局”吗？欢迎在评论区分享你的踩坑故事！

一句话复盘：引入了 mybatis-spring-boot-starter，却忘了配数据库——Spring Boot 的自动装配机制当场“罢工”。

【踩坑记录】Spring Boot + MyBatis 启动失败：DataSource url not specified

后端

数据库

开发工具

SpringBoot项目引入mybatis-spring-boot-starter后必须配置数据库，否则会因DataSourceAutoConfiguration自动配置失败而无法启动。解决方案包括：配置MySQL连接信息、排除自动配置或使用H2内存数据库。注意YAML配置格式和依赖版本，避免常见启动错误。

单元测试

PostgreSQL

MySQL

2026采购季 | AI焕新·智启新局

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【踩坑记录】Spring Boot + MyBatis 启动失败：DataSource url not specified-腾讯云开发者社区-腾讯云

【踩坑记录】Spring Boot + MyBatis 启动失败：DataSource url not specified

【踩坑记录】Spring Boot + MyBatis 启动失败：DataSource url not specified

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐