MyBatis-Plus如何配置環境

# MyBatis-Plus如何配置環境

MyBatis-Plus（簡稱MP）是MyBatis的增強工具，在保留原生功能的基礎上提供了更多便捷功能。本文將詳細介紹如何從零開始配置MyBatis-Plus環境。

## 一、環境準備

### 1. 基礎依賴
確保項目中已包含：
- JDK 1.8+
- Maven 3.0+
- Spring Boot 2.x（可選）
- MyBatis 3.5+

### 2. 開發工具推薦
- IDEA/Eclipse
- MySQL 5.7+
- Postman（API測試）

## 二、Maven項目配置

### 1. 添加核心依賴
```xml
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

2. Spring Boot配置（application.yml）

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mp_demo?useSSL=false
    username: root
    password: 123456

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 開啟SQL日志
  global-config:
    db-config:
      id-type: auto # 主鍵自增策略

三、基礎配置類

1. 主啟動類配置

@SpringBootApplication
@MapperScan("com.example.mapper") // 掃描Mapper接口
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2. 分頁插件配置

@Configuration
public class MybatisPlusConfig {
    
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

四、代碼生成器（可選）

1. 添加生成器依賴

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>3.5.3.1</version>
</dependency>
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
</dependency>

2. 生成器配置示例

FastAutoGenerator.create("jdbc:mysql://localhost:3306/mp_demo", "root", "123456")
    .globalConfig(builder -> builder.outputDir("src/main/java"))
    .packageConfig(builder -> builder.parent("com.example"))
    .strategyConfig(builder -> builder.addInclude("user"))
    .execute();

五、常見問題解決

1. 數據庫連接失敗

• 檢查spring.datasource配置
• 確認MySQL服務已啟動
• 驗證用戶名密碼是否正確

2. 實體類與表映射問題

• 使用@TableName注解指定表名
• 通過@TableId標注主鍵
• 字段映射使用@TableField

3. SQL不打印問題

檢查是否配置了日志實現：

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

六、擴展配置

1. 多數據源配置

建議使用第三方組件：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
    <version>3.6.1</version>
</dependency>

2. 性能分析插件

@Bean
public PerformanceInterceptor performanceInterceptor() {
    PerformanceInterceptor interceptor = new PerformanceInterceptor();
    interceptor.setFormat(true); // 格式化SQL
    return interceptor;
}

通過以上步驟即可完成MyBatis-Plus的基礎環境配置。更多高級功能可參考官方文檔。 “`

該文檔包含： 1. 環境要求說明 2. 分步驟的配置指南 3. 代碼示例和YAML配置 4. 常見問題解決方案 5. 擴展功能建議 6. 官方文檔引用

可根據實際項目需求調整數據庫配置、包路徑等參數。建議在正式項目中使用更高版本的依賴。