✅ Spring Boot + MyBatis-Flex 配置 ProxySQL 的完整指南

下面是一个详细的教程，指导您如何在 Spring Boot 项目中使用 MyBatis-Flex 配置 ProxySQL 进行 读写分离 和 主从同步 的数据库访问。

---

🎯 目标

1. 在 Spring Boot 中连接 ProxySQL。
2. 使用 MyBatis-Flex 访问数据库。
3. 配置 读写分离 和 延迟检测。

---

🔧 步骤 1：确保 ProxySQL 和 MySQL 主从同步已正确配置

首先，确保您已经正确配置了 ProxySQL 和 MySQL 主从同步。

ProxySQL 的默认配置

Hostgroup ID	描述
10	主库（写操作）
20	从库（读操作）

ProxySQL 的数据端口

• 端口：6033（默认数据接口端口）

---

🔧 步骤 2：在 Spring Boot 项目中引入依赖

1️⃣ 引入 MyBatis-Flex 的依赖

在 pom.xml 中添加以下依赖：

<dependency><groupId>com.mybatisflex</groupId><artifactId>mybatis-flex-spring-boot-starter</artifactId><version>1.4.3</version>
</dependency>

---

🔧 步骤 3：配置 application.yml

在 application.yml 文件中配置 ProxySQL 的数据源。

spring:datasource:url: jdbc:mysql://127.0.0.1:6033/db_order_plus?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghaiusername: rootpassword: rootmybatis-flex:mapper-locations: classpath:mapper/**/*Mapper.xmlconfiguration:map-underscore-to-camel-case: true

---

🔧 步骤 4：配置数据源的读写分离

在 ProxySQL 中配置 读写分离规则：

在 ProxySQL 管理界面执行以下 SQL

INSERT INTO mysql_query_rules (rule_id, active, match_pattern, destination_hostgroup)
VALUES (1, 1, '^SELECT.*', 20),(2, 1, '^INSERT.*|^UPDATE.*|^DELETE.*', 10);LOAD MYSQL QUERY RULES TO RUNTIME;
SAVE MYSQL QUERY RULES TO DISK;

---

🔧 步骤 5：创建 MyBatis-Flex 的 Mapper 和实体类

1️⃣ 创建实体类

在 com.example.demo.entity 包中创建一个实体类，例如 Order.java：

package com.example.demo.entity;public class Order {private Long id;private String orderName;// Getters and Setters
}

2️⃣ 创建 Mapper 接口

在 com.example.demo.mapper 包中创建一个 Mapper 接口：

package com.example.demo.mapper;import com.example.demo.entity.Order;
import org.apache.ibatis.annotations.Select;public interface OrderMapper {@Select("SELECT * FROM orders WHERE id = #{id}")Order selectOrderById(Long id);
}

3️⃣ 创建 Mapper XML 文件

在 src/main/resources/mapper 目录下创建 OrderMapper.xml：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.example.demo.mapper.OrderMapper"><select id="selectOrderById" resultType="com.example.demo.entity.Order">SELECT * FROM orders WHERE id = #{id}</select>
</mapper>

---

🔧 步骤 6：创建 Service 和 Controller

1️⃣ 创建 Service

在 com.example.demo.service 包中创建一个 OrderService：

package com.example.demo.service;import com.example.demo.entity.Order;
import com.example.demo.mapper.OrderMapper;
import org.springframework.stereotype.Service;@Service
public class OrderService {private final OrderMapper orderMapper;public OrderService(OrderMapper orderMapper) {this.orderMapper = orderMapper;}public Order getOrderById(Long id) {return orderMapper.selectOrderById(id);}
}

2️⃣ 创建 Controller

在 com.example.demo.controller 包中创建一个 OrderController：

package com.example.demo.controller;import com.example.demo.entity.Order;
import com.example.demo.service.OrderService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;@RestController
public class OrderController {private final OrderService orderService;public OrderController(OrderService orderService) {this.orderService = orderService;}@GetMapping("/orders/{id}")public Order getOrderById(@PathVariable Long id) {return orderService.getOrderById(id);}
}

---

🔧 步骤 7：测试读写分离

1. 启动 Spring Boot 项目：

mvn spring-boot:run

2. 测试写操作（INSERT/UPDATE/DELETE）

通过 Navicat 或其他工具，向数据库执行写操作，确保这些操作路由到 主库。

3. 测试读操作（SELECT）

访问 http://localhost:8080/orders/{id}，验证读操作是否路由到 从库。

---

🔧 步骤 8：配置延迟检测

在 ProxySQL 中启用 延迟检测：

SET mysql-monitor_replication_lag_interval_ms = 1000;INSERT INTO mysql_replication_hostgroups (writer_hostgroup, reader_hostgroup, check_type, max_replication_lag)
VALUES (10, 20, 'seconds_behind_master', 5);LOAD MYSQL VARIABLES TO RUNTIME;
SAVE MYSQL VARIABLES TO DISK;

---

✅ 总结

步骤	描述
安装 MyBatis-Flex	在项目中引入 MyBatis-Flex
配置数据源	在 application.yml 中配置 ProxySQL 的数据源
配置读写分离规则	在 ProxySQL 中配置读写分离规则
创建实体类、Mapper、Service、Controller	实现数据库访问逻辑
启用延迟检测	在 ProxySQL 中启用延迟检测