SpringBoot+MyBatis+MySQL项目搭建与优化指南

成为夏目

1. 项目概述

作为一名长期使用IntelliJ IDEA进行Java开发的工程师，我经常需要快速搭建SpringBoot项目骨架。今天我将分享一个完整的SpringBoot+MyBatis+MySQL工程搭建指南，这个配置方案已经在我参与的多个电商和ERP系统中得到验证。

这个技术栈组合特别适合需要快速迭代的中小型项目。SpringBoot的自动配置让我们免去了繁琐的XML配置，MyBatis提供了灵活的SQL控制能力，而MySQL作为最流行的开源关系型数据库，三者组合能快速构建出健壮的数据访问层。下面我会从环境准备开始，详细演示每个关键步骤。

2. 开发环境准备

2.1 基础软件安装

在开始前，请确保已安装以下组件：

JDK 1.8或更高版本（推荐Amazon Corretto 11）
IntelliJ IDEA 2022.3+（社区版或旗舰版）
MySQL 8.0+（建议使用Docker容器运行）
Maven 3.6.3+

提示：使用Docker运行MySQL可以避免污染本地环境，启动命令：docker run --name mysql8 -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 -d mysql:8.0 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

2.2 IDEA基础配置

设置全局编码：
- File → Settings → Editor → File Encodings
- 将所有编码设置为UTF-8
- 勾选"Transparent native-to-ascii conversion"

配置Maven：

File → Settings → Build → Maven
设置本地仓库路径（避免使用C盘）

建议使用阿里云镜像：

xml复制<mirror>
  <id>aliyun</id>
  <mirrorOf>*</mirrorOf>
  <name>Aliyun</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

3. 项目初始化

3.1 创建SpringBoot项目

在IDEA中选择File → New → Project
左侧选择Spring Initializr
填写项目元信息：
- Group: com.example
- Artifact: demo
- Type: Maven
- Java版本: 11
依赖选择：
- Spring Web
- MyBatis Framework
- MySQL Driver
- Lombok（简化实体类）

3.2 项目结构验证

创建完成后应看到标准Maven结构：

code复制src
├── main
│   ├── java
│   │   └── com
│   │       └── example
│   │           └── demo
│   │               └── DemoApplication.java
│   └── resources
│       ├── application.yml
│       ├── static
│       └── templates
└── test
    └── java

3.3 关键POM依赖

检查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>2.2.2</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

4. 数据库配置

4.1 MySQL准备

创建测试数据库和表：

sql复制CREATE DATABASE demo_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE TABLE user (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    password VARCHAR(100) NOT NULL,
    email VARCHAR(100),
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

INSERT INTO user(username, password, email) VALUES
('admin', '123456', 'admin@example.com'),
('test', 'test123', 'test@example.com');

4.2 配置数据源

在application.yml中添加：

yaml复制spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo_db?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 10
      minimum-idle: 5
      connection-timeout: 30000

mybatis:
  mapper-locations: classpath:mapper/*.xml
  configuration:
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

注意：生产环境密码应该使用加密配置，推荐使用Jasypt或Vault

5. MyBatis集成开发

5.1 实体类创建

使用Lombok简化代码：

java复制@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Long id;
    private String username;
    private String password;
    private String email;
    private Date createTime;
}

5.2 Mapper接口

创建UserMapper.java：

java复制@Mapper
public interface UserMapper {
    @Select("SELECT * FROM user")
    List<User> findAll();
    
    @Insert("INSERT INTO user(username, password, email) VALUES(#{username}, #{password}, #{email})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int insert(User user);
    
    @Update("UPDATE user SET username=#{username}, email=#{email} WHERE id=#{id}")
    int update(User user);
    
    @Delete("DELETE FROM user WHERE id=#{id}")
    int delete(Long id);
}

5.3 Service层实现

java复制@Service
@RequiredArgsConstructor
public class UserService {
    private final UserMapper userMapper;
    
    public List<User> listAll() {
        return userMapper.findAll();
    }
    
    public int createUser(User user) {
        return userMapper.insert(user);
    }
    
    public int updateUser(User user) {
        return userMapper.update(user);
    }
    
    public int deleteUser(Long id) {
        return userMapper.delete(id);
    }
}

5.4 Controller开发

java复制@RestController
@RequestMapping("/api/users")
@RequiredArgsConstructor
public class UserController {
    private final UserService userService;
    
    @GetMapping
    public ResponseEntity<List<User>> listUsers() {
        return ResponseEntity.ok(userService.listAll());
    }
    
    @PostMapping
    public ResponseEntity<Void> addUser(@RequestBody User user) {
        userService.createUser(user);
        return ResponseEntity.created(URI.create("/api/users/" + user.getId())).build();
    }
    
    @PutMapping("/{id}")
    public ResponseEntity<Void> updateUser(@PathVariable Long id, @RequestBody User user) {
        user.setId(id);
        userService.updateUser(user);
        return ResponseEntity.noContent().build();
    }
    
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();
    }
}

6. 高级配置与优化

6.1 MyBatis分页插件

添加PageHelper支持：

在pom.xml中添加依赖：

xml复制<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.3</version>
</dependency>

修改Service方法：

java复制public PageInfo<User> listByPage(int pageNum, int pageSize) {
    PageHelper.startPage(pageNum, pageSize);
    List<User> users = userMapper.findAll();
    return new PageInfo<>(users);
}

6.2 事务管理

在Service方法上添加事务注解：

java复制@Transactional(rollbackFor = Exception.class)
public int createUser(User user) {
    // 业务逻辑...
}

6.3 多数据源配置

对于需要连接多个数据库的场景：

配置多个数据源：

yaml复制spring:
  datasource:
    primary:
      url: jdbc:mysql://localhost:3306/db1
      username: user1
      password: pass1
    secondary:
      url: jdbc:mysql://localhost:3306/db2
      username: user2
      password: pass2

创建配置类：

java复制@Configuration
public class DataSourceConfig {
    @Bean
    @Primary
    @ConfigurationProperties("spring.datasource.primary")
    public DataSource primaryDataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    @ConfigurationProperties("spring.datasource.secondary")
    public DataSource secondaryDataSource() {
        return DataSourceBuilder.create().build();
    }
}

7. 常见问题排查

7.1 连接池问题

症状：应用运行一段时间后出现连接超时
解决方案：

检查HikariCP配置：

yaml复制spring:
  datasource:
    hikari:
      connection-timeout: 30000
      maximum-pool-size: 10
      idle-timeout: 600000
      max-lifetime: 1800000

添加连接测试查询：

yaml复制spring:
  datasource:
    hikari:
      connection-test-query: SELECT 1

7.2 MyBatis映射问题

症状：查询结果字段为null
解决方案：

确认数据库字段名与实体类属性名匹配
开启驼峰命名转换：

yaml复制mybatis:
  configuration:
    map-underscore-to-camel-case: true

检查SQL日志：

yaml复制logging:
  level:
    com.example.demo.mapper: debug

7.3 事务失效场景

常见原因：

方法不是public
自调用（同一个类中方法调用）
异常类型不匹配（默认只回滚RuntimeException）
数据库引擎不支持（如MyISAM）

验证方法：

java复制@SpringBootTest
class TransactionTest {
    @Autowired
    private UserService userService;
    
    @Test
    void testTransaction() {
        try {
            userService.testTransactional();
        } catch (Exception e) {
            // 检查数据库是否回滚
        }
    }
}

8. 项目优化建议

8.1 代码生成器

使用MyBatis Generator自动生成基础代码：

添加插件到pom.xml：

xml复制<plugin>
    <groupId>org.mybatis.generator</groupId>
    <artifactId>mybatis-generator-maven-plugin</artifactId>
    <version>1.4.1</version>
    <configuration>
        <configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
        <overwrite>true</overwrite>
    </configuration>
</plugin>

示例generatorConfig.xml：

xml复制<context id="mysql" targetRuntime="MyBatis3">
    <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                    connectionURL="jdbc:mysql://localhost:3306/demo_db"
                    userId="root"
                    password="123456"/>
    
    <javaModelGenerator targetPackage="com.example.demo.model" 
                       targetProject="src/main/java"/>
    
    <sqlMapGenerator targetPackage="mapper" 
                    targetProject="src/main/resources"/>
    
    <javaClientGenerator type="XMLMAPPER" 
                        targetPackage="com.example.demo.mapper" 
                        targetProject="src/main/java"/>
    
    <table tableName="user" domainObjectName="User"/>
</context>

8.2 性能监控

集成Spring Boot Actuator监控数据源：

添加依赖：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

配置暴露端点：

yaml复制management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics
  metrics:
    tags:
      application: ${spring.application.name}

访问监控数据：

code复制http://localhost:8080/actuator/metrics/hikaricp.connections.usage

8.3 安全加固

数据库密码加密：

yaml复制spring:
  datasource:
    password: ENC(加密后的密码)

使用Druid连接池的安全特性：

xml复制<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.8</version>
</dependency>

配置防火墙规则和SQL注入防护

9. 测试策略

9.1 单元测试

使用SpringBootTest测试Mapper：

java复制@SpringBootTest
class UserMapperTest {
    @Autowired
    private UserMapper userMapper;
    
    @Test
    void testFindAll() {
        List<User> users = userMapper.findAll();
        assertFalse(users.isEmpty());
    }
}

9.2 集成测试

测试Controller层：

java复制@AutoConfigureMockMvc
@SpringBootTest
class UserControllerTest {
    @Autowired
    private MockMvc mockMvc;
    
    @Test
    void testListUsers() throws Exception {
        mockMvc.perform(get("/api/users"))
               .andExpect(status().isOk())
               .andExpect(jsonPath("$[0].username").exists());
    }
}

9.3 性能测试

使用JMeter进行压力测试：

创建线程组（100并发）
添加HTTP请求采样器（指向/list接口）
添加聚合报告监听器
重点关注：
- 平均响应时间 < 200ms
- 错误率 < 0.1%
- 吞吐量 > 500 req/s

10. 部署实践

10.1 打包应用

使用Maven打包可执行JAR：

bash复制mvn clean package -DskipTests

10.2 Docker化部署

创建Dockerfile：

dockerfile复制FROM openjdk:11-jre-slim
COPY target/demo-0.0.1-SNAPSHOT.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建并运行：

bash复制docker build -t demo-app .
docker run -d -p 8080:8080 --name demo demo-app

10.3 生产建议

使用Nginx做反向代理和负载均衡

配置JVM参数：

bash复制java -jar -Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m app.jar

设置健康检查端点：

yaml复制management:
  endpoint:
    health:
      show-details: always

11. 开发技巧分享

11.1 IDEA高效操作

MyBatis插件推荐：
- MyBatisX：Mapper接口与XML快速跳转
- Free MyBatis Tool：生成XML模板
代码模板：
- 创建Live Template快速生成@RestController
- 自定义文件模板（Settings → Editor → File and Code Templates）
数据库工具：
- 配置Database面板连接MySQL
- 使用SQL语句自动补全

11.2 调试技巧

MyBatis SQL日志：

yaml复制logging:
  level:
    org.mybatis: debug

条件断点：
- 在Mapper接口方法上设置断点
- 右键断点添加条件（如id==1）

HTTP客户端：

使用IDEA内置的HTTP Client测试API

示例请求：

code复制###
GET http://localhost:8080/api/users
Accept: application/json

11.3 团队协作规范

代码风格：
- 统一MyBatis的XML格式（缩进、标签顺序）
- Mapper方法命名规范（selectByXxx, updateXxx）
分层原则：
- Controller只处理HTTP协议转换
- Service实现业务逻辑
- Mapper只做数据访问
版本控制：
- 分离SQL脚本（V1__init.sql）
- 使用Git管理MyBatis的XML变更

12. 扩展学习方向

12.1 MyBatis进阶

动态SQL：

xml复制<select id="findByCondition" resultType="User">
  SELECT * FROM user
  <where>
    <if test="username != null">
      AND username = #{username}
    </if>
    <if test="email != null">
      AND email LIKE CONCAT('%',#{email},'%')
    </if>
  </where>
</select>

类型处理器：

java复制@MappedTypes(String.class)
@MappedJdbcTypes(JdbcType.VARCHAR)
public class EncryptTypeHandler implements TypeHandler<String> {
    // 实现加解密逻辑
}

插件开发：

java复制@Intercepts({
    @Signature(type= Executor.class, method="update", 
              args={MappedStatement.class,Object.class})
})
public class MyPlugin implements Interceptor {
    // 实现拦截逻辑
}

12.2 SpringBoot整合

整合Redis缓存：

java复制@Cacheable(value = "user", key = "#id")
public User getById(Long id) {
    return userMapper.selectById(id);
}

整合RabbitMQ消息队列：

java复制@RabbitListener(queues = "user.queue")
public void processUserCreate(User user) {
    // 处理用户创建消息
}

整合Elasticsearch：

java复制public interface UserRepository extends ElasticsearchRepository<User, Long> {
    List<User> findByUsername(String username);
}

12.3 架构演进

多模块拆分：

code复制project
├── user-service
│   ├── src
│   └── pom.xml
├── order-service
│   ├── src
│   └── pom.xml
└── pom.xml (父POM)

微服务改造：
- 引入Spring Cloud
- 使用Feign实现服务调用
- 配置Spring Cloud Gateway
云原生部署：
- 使用Kubernetes管理容器
- 配置ConfigMap和Secret
- 实现自动扩缩容

13. 项目实战建议

13.1 电商系统案例

典型数据流：

用户服务（User）
商品服务（Product）
订单服务（Order）
支付服务（Payment）

数据库设计要点：

用户表与订单表一对多
商品表与订单项表一对多
支付表与订单表一对一

13.2 CMS系统案例

核心功能：

用户权限管理（RBAC）
内容发布流程
多级分类系统
标签管理

性能优化点：

使用Redis缓存热点数据
实现静态化页面生成
配置读写分离数据源

13.3 物联网平台案例

特殊需求：

设备管理（Device）
数据采集（Metric）
告警规则（Alert）
数据分析（Report）

技术挑战：

处理高频写入
实现时序数据存储
支持大规模设备连接

14. 性能调优记录

14.1 SQL优化实例

问题：用户列表查询慢（>2s）
分析：

使用EXPLAIN分析执行计划
发现缺少username索引

解决方案：

sql复制ALTER TABLE user ADD INDEX idx_username (username);

效果：查询时间降至200ms以内

14.2 连接池配置

初始配置：

yaml复制maximum-pool-size: 50

问题：高并发时出现连接等待
调整：

yaml复制maximum-pool-size: 20
connection-timeout: 3000

原理：根据实际TPS计算，20连接足够支持500QPS

14.3 JVM调优

默认参数：

Xms256m
Xmx256m

问题：频繁GC影响性能
调整：

bash复制java -jar -Xms512m -Xmx1024m -XX:+UseG1GC app.jar

监控工具：

VisualVM
Arthas

15. 安全防护实践

15.1 SQL注入防护

始终使用参数化查询：

java复制@Select("SELECT * FROM user WHERE username = #{name}")
User findByUsername(@Param("name") String username);

避免拼接SQL：

java复制// 错误示范
@Select("SELECT * FROM user WHERE username = '" + name + "'")

使用MyBatis的<bind>标签处理LIKE：

xml复制<bind name="pattern" value="'%' + name + '%'" />
SELECT * FROM user WHERE username LIKE #{pattern}

15.2 数据脱敏

实现自定义TypeHandler：

java复制public class SensitiveTypeHandler implements TypeHandler<String> {
    @Override
    public void setParameter(...) {
        // 加密逻辑
    }
    
    @Override
    public String getResult(...) {
        // 解密逻辑
    }
}

在字段上指定：

java复制@Column(typeHandler = SensitiveTypeHandler.class)
private String idCard;

15.3 审计日志

使用MyBatis插件记录操作：

java复制@Intercepts(@Signature(type= Executor.class, method="update", ...))
public class AuditLogPlugin implements Interceptor {
    // 记录修改操作
}

存储到日志文件或数据库

16. 持续集成方案

16.1 GitLab CI配置

示例.gitlab-ci.yml：

yaml复制stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - mvn clean package -DskipTests

test:
  stage: test
  script:
    - mvn test

deploy:
  stage: deploy
  script:
    - scp target/*.jar user@server:/app/
  only:
    - master

16.2 Jenkins流水线

Jenkinsfile示例：

groovy复制pipeline {
    agent any
    
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
            }
        }
        
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
        
        stage('Deploy') {
            steps {
                sshPublisher(
                    publishers: [
                        sshPublisherDesc(
                            configName: 'prod-server',
                            transfers: [
                                sshTransfer(
                                    sourceFiles: 'target/*.jar',
                                    remoteDirectory: '/app'
                                )
                            ]
                        )
                    ]
                )
            }
        }
    }
}

16.3 质量门禁

集成SonarQube：

xml复制<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.9.1</version>
</plugin>

运行扫描：

bash复制mvn sonar:sonar -Dsonar.host.url=http://sonar-server:9000

设置质量阈值：
- 覆盖率 > 70%
- 重复率 < 5%
- 0严重漏洞

17. 监控告警体系

17.1 Prometheus监控

添加依赖：

xml复制<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

配置端点：

yaml复制management:
  endpoints:
    web:
      exposure:
        include: prometheus
  metrics:
    export:
      prometheus:
        enabled: true

监控指标：
- http_server_requests_seconds
- jvm_memory_used
- hikaricp_connections_active

17.2 Grafana仪表板

导入Spring Boot仪表板（ID: 6756）
关键面板：
- JVM内存使用
- HTTP请求延迟
- 数据库连接池状态
设置告警规则

17.3 日志收集

ELK架构：
- Filebeat收集日志
- Logstash处理
- Elasticsearch存储
- Kibana展示

日志格式规范：

java复制private static final Logger log = LoggerFactory.getLogger(UserController.class);

log.info("Get user by id: {}", id);
log.error("Failed to create user", ex);

追踪ID：

java复制@GetMapping
public List<User> list(@RequestHeader("X-Request-ID") String requestId) {
    MDC.put("requestId", requestId);
    // ...
}

18. 项目文档规范

18.1 API文档

使用Swagger UI：