第02章 MyBatis 环境搭建

搭建完整的 MyBatis 开发环境和项目结构
学习进度：8% 代码演示按钮 💻 查看完整代码 - 在线IDE体验

🎯 学习目标

📚

理解核心概念

掌握本章的核心概念和基本原理
🔧

掌握实践技能

学会相关的配置方法和实践技巧
💡

了解应用场景

明确在实际项目中的应用场景和最佳实践

🎯 环境要求概览

☕ Java 环境

JDK 8+

推荐使用 JDK 11 或 JDK 17

📦 构建工具

Maven 3.6+

用于项目依赖管理

🗄️ 数据库

MySQL 5.7+

或其他关系型数据库

💻 开发工具

IntelliJ IDEA

或 Eclipse、VS Code

🚀 环境搭建步骤

1JDK 环境配置

首先需要安装并配置 Java 开发环境：

下载并安装 JDK 8 或更高版本
配置 JAVA_HOME 环境变量
将 JDK 的 bin 目录添加到 PATH
验证安装：java -version

# 验证 Java 安装
$ java -version
java version "11.0.12" 2021-07-20 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.12+8-LTS-237)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.12+8-LTS-237, mixed mode)

2Maven 环境配置

Maven 是 Java 项目的依赖管理和构建工具：

下载并安装 Maven 3.6 或更高版本
配置 MAVEN_HOME 环境变量
将 Maven 的 bin 目录添加到 PATH
验证安装：mvn -version

# 验证 Maven 安装
$ mvn -version
Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)
Maven home: /usr/local/apache-maven-3.8.4
Java version: 11.0.12, vendor: Oracle Corporation

3IDE 开发工具

选择合适的集成开发环境：

IntelliJ IDEA（推荐）：功能强大，对 Java 支持最好
Eclipse：免费开源，插件丰富
VS Code：轻量级，适合简单项目

💡 提示：本教程推荐使用 IntelliJ IDEA，它对 MyBatis 有很好的支持，包括 SQL 语法高亮、自动补全等功能。

4数据库环境准备

准备数据库环境用于 MyBatis 连接：

安装 MySQL 5.7 或更高版本
启动 MySQL 服务
创建测试数据库
配置数据库用户权限

# 创建测试数据库
CREATE DATABASE mybatis_demo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 创建测试用户（可选）
CREATE USER 'mybatis_user'@'localhost' IDENTIFIED BY 'password123';
GRANT ALL PRIVILEGES ON mybatis_demo.* TO 'mybatis_user'@'localhost';
FLUSH PRIVILEGES;

5创建 Maven 项目

使用 Maven 创建标准的 Java 项目结构：

# 使用 Maven 原型创建项目
mvn archetype:generate -DgroupId=com.example.mybatis \
                       -DartifactId=mybatis-demo \
                       -DarchetypeArtifactId=maven-archetype-quickstart \
                       -DinteractiveMode=false

📁 项目目录结构

标准的 MyBatis 项目应该具有以下目录结构：

mybatis-demo/
├── pom.xml # Maven 配置文件
├── src/
│ ├── main/
│ │ ├── java/ # Java 源代码
│ │ │ └── com/example/
│ │ │ ├── entity/ # 实体类（POJO）
│ │ │ ├── mapper/ # Mapper 接口
│ │ │ ├── service/ # 业务逻辑层
│ │ │ └── util/ # 工具类
│ │ └── resources/ # 资源文件
│ │ ├── mybatis-config.xml # MyBatis 主配置文件
│ │ ├── mappers/ # SQL 映射文件
│ │ ├── db.properties # 数据库配置
│ │ └── log4j.properties # 日志配置
│ └── test/ # 测试代码
│ └── java/
└── target/ # 编译输出目录

🔧 MyBatis 依赖配置

在 pom.xml 中添加 MyBatis 相关依赖：

<dependencies>
    <!-- MyBatis 核心依赖 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.13</version>
    </dependency>
    
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
    </dependency>
    
    <!-- 日志依赖 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    
    <!-- 测试依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

✅ 环境验证

完成环境搭建后，可以通过以下方式验证：

🔍 验证清单✅ Java 版本检查：java -version✅ Maven 版本检查：mvn -version✅ 数据库连接测试✅ IDE 项目导入成功✅ Maven 依赖下载完成✅ 项目编译无错误：mvn compile

🚨 常见问题解决

问题 1：Java 版本不兼容

现象：编译时出现版本不兼容错误解决：确保 JDK 版本 ≥ 8，并在 pom.xml 中指定正确的编译版本

问题 2：Maven 依赖下载失败

现象：依赖包无法下载或下载缓慢解决：配置国内 Maven 镜像源，如阿里云镜像

问题 3：数据库连接失败

现象：无法连接到 MySQL 数据库解决：检查数据库服务状态、连接参数、用户权限

💡 本章小结

本章我们学习了MyBatis开发环境的完整搭建过程，包括JDK和Maven的安装配置、IDE开发工具的选择、数据库环境的准备、Maven项目的创建和依赖配置、项目目录结构的规范以及环境验证和问题排查。掌握了这些基础环境配置后，我们就可以开始MyBatis的实际开发了。下一章预告：我们将创建第一个MyBatis程序，学习MyBatis的基本配置文件、映射文件的编写，以及如何执行第一个数据库操作。

下一章节 🎉

恭喜完成本章学习！

你已经掌握了 MyBatis 环境搭建的核心知识
第03章

第一个MyBatis程序

学习MyBatis的基本配置文件、映射文件编写，以及如何执行第一个数据库操作
⭐⭐ 基础⏱️ 30分钟开始学习 → ← 第01章 📚 课程目录第03章 →