使用 ProxySQL 为 Magento 2 做主从配置(完整教程)

项 内容
文档版本 2026-11-17 v1.0
适用对象 Magento Open Source 2.4.x(本文以本项目 2.4.9 + PHP 8.5 + CDB MySQL 8.4 为基准)
目标 在不改动 Magento 代码、不执行 di:compile 的前提下,用 ProxySQL 把只读查询分流到 MySQL 从库(read replica)
前提 已有可用的 MySQL 主库 和 只读实例;本文不负责搭建 MySQL 复制本身
风险等级 中(新增一层代理,需双实例;规则配置错误会导致页面 500 或读到脏数据)

目录

  1. 历史背景:从 Magento 1 到 Magento 2,读写分离能力如何丢失
  2. 为什么社区版只能用 ProxySQL
  3. 原理:ProxySQL 在 Magento 请求链路中的位置
  4. 前置条件与准备
  5. 安装 ProxySQL
  6. 后端定义:主库 / 从库 / 健康检查
  7. 用户与连接管理
  8. 路由规则:核心设计
  9. Magento 侧接入
  10. 灰度、验证与观测
  11. 监控与告警
  12. 故障处理与回滚
  13. 常见问题(FAQ)
  14. 本项目适配说明(实测数据)
  15. 附录:完整配置与脚本

1. 历史背景:读写分离能力是怎么一步步丢掉的

1.1 Magento 1 时代(2008—2015)

Magento 1 的数据库连接配置集中在 app/etc/local.xml:

<resources>
    <db>
        <default_setup>
            <connection>
                <host>master.db</host>
                <username>magento</username>
                ...
            </connection>
        </default_setup>
    </db>
</resources>

Magento 1 企业版(EE) 在同一份配置里支持为资源额外指定从库连接,配合 MySQL 原生主从复制,把只读查询(目录、CMS)导向从库;社区版(CE)没有这个能力。这一能力常被记作 “master/slave” 或 “use_slave”。

这也是很多老运维"记得 Magento 支持读写分离"的源头——他们当年用的是 EE。

1.2 Magento 2 的重构(2015 至今)

Magento 2 把数据库访问抽象成 Magento\Framework\App\ResourceConnection,但重构时只保留了"多命名连接",没有保留"读写判断":

// vendor/magento/framework/App/ResourceConnection.php:108
public function getConnection($resourceName = self::DEFAULT_CONNECTION)
{
    $connectionName = $this->config->getConnectionName($resourceName);
    return $this->getConnectionByName($connectionName);
}

getConnectionName() 会去读 app/etc/config.php 的 resource.<name>.connection 映射,找不到就回落 default(ResourceConnection/Config.php:62-77)。整个链路里没有任何一处根据"这条 SQL 是读还是写"来选择连接。

1.3 企业版仍有,社区版没有

能力 载体 社区版(CE) 企业版(Adobe Commerce)
主/从连接分离(db.slave_connection) 独立模块 Magento_ResourceConnections :cross_mark: 不可得 :white_check_mark: 内置
按业务域拆库(main / checkout / sales) Split Database 部署方案 :cross_mark: :white_check_mark:
多命名连接(getConnection('sales')) Magento\Framework 核心 :white_check_mark: 代码在,但没有对应连接配置 :white_check_mark:

本项目 2026-11-17 的实测证据(关键):

$ ls vendor/magento/module-resource-connections
未安装

$ grep -c 'module-resource-connections' composer.lock
0                                   # 397 个 magento/* 包中无此包

$ grep -c 'ResourceConnections' app/etc/config.php
0

# Marketplace 仓库解析(隔离目录 + /root/.composer 凭据)
require: magento/module-resource-connections  → could not be found in any version
require: magento/module-catalog 103.0.*       → satisfiable by 103.0.0 … 103.0.7-p3(仅 PHP 版本不满足)

对照实验证明 凭据有效、仓库可达,所以结论是:该包不在社区版可下载的包集合里。

Adobe 官方模块参考页(developer.adobe.com/commerce/php/module-reference/module-resource-connections)描述的能力是真实的,但它属于 Adobe Commerce 分发内容;文档页的"both editions"口径与实际包分发不一致——以 composer 能否解析为准。

1.4 一个容易误会的"残留"

社区版框架里仍能看到 slave_connection 字样:

// vendor/magento/framework/DB/Helper/InitStatementsCleanup.php:130
if (isset($envConfig['db']['slave_connection']) && is_array($envConfig['db']['slave_connection'])) {

它只是"清理 SET NAMES 旧语句"时会顺带遍历 db/slave_connection,不代表 CE 具备读写分离能力。写了 slave_connection 也不会生效——这是最容易误判为"配一下就行"的地方。

1.5 所以,社区版只剩三条路

路径 是否改代码 是否要 di:compile 风险 适用
自研 plugin(getConnection('read')) :white_check_mark: 要 :white_check_mark: 要 中高(回归面广) 精细控制
ProxySQL 中间件 :cross_mark: 不用 :cross_mark: 不用 中(新增单点) 本文方案
MySQL Router :cross_mark: 不用 :cross_mark: 不用 中(功能比 ProxySQL 弱) 简单场景

2. 为什么社区版只能用 ProxySQL

Magento 社区版对数据库的使用有三个特点,决定了外部代理是唯一"零代码"方案:

  1. 全部走默认连接:env.php 只有 db.connection.default,所有 ResourceModel 都用它。
  2. SQL 由 PHP 拼装:Zend_Db_Select::assemble() 生成完整 SQL 文本再发送。
  3. 模拟预处理:PDO::ATTR_EMULATE_PREPARES = true(vendor/magento/framework/DB/Adapter/Pdo/Mysql.php:561)——没有 server-side prepared statement。

第 3 点对 ProxySQL 是重大利好:代理看到的是完整、带参数的 SQL 文本,match_pattern / digest 规则都能稳定命中,不会遇到 PREPARE/EXECUTE 协议带来的匹配困难。


3. 原理:ProxySQL 在链路中的位置

Cloudflare → nginx:8443 → Varnish:8080 → nginx:8083 → PHP-FPM
                                                          │ PDO 3306
                                                          ▼
                                                    ProxySQL :6033
                                                    ├── hostgroup 10 → MySQL 主库
                                                    └── hostgroup 20 → MySQL 只读实例

Magento 视角:env.php 的 host 从 主库IP:3306 改成 ProxySQL_IP:6033,其余一律不变。ProxySQL 按规则决定每条 SQL 去哪个 hostgroup。

三条铁律(后面所有配置都围绕它们):

  1. 默认走主库,只有白名单 SQL 才去从库;
  2. 事务内全部留在同一 hostgroup(transaction_persistent);
  3. 临时表生命周期不能跨 hostgroup(Magento 的 search_tmp_* 是 session 级 MEMORY 表)。

4. 前置条件与准备

4.1 必须具备

项 检查方式 期望
只读实例可用 mysql -h<replica> -e "SELECT @@read_only, @@server_id, @@hostname" read_only=1,server_id 与主库不同
复制正常 SHOW REPLICA STATUS Replica_IO_Running=Yes、Replica_SQL_Running=Yes、Seconds_Behind_Source 稳定
账号 主库/从库同一组账号 应用账号需在从库同样存在且有只读权限
网络 应用机到 ProxySQL、ProxySQL 到两台 MySQL 同 VPC,RTT < 1ms

本项目现状提醒:172.26.0.10:3306 实测 read_only=0、hostname=mysql-0、Com_insert 持续增长,它是主库。不要把它当成从库填进 hostgroup 20,否则 ProxySQL 会把主库当 reader,读写分离形同虚设且难以察觉。

4.2 建议准备

  • 一台独立小规格节点跑 ProxySQL(剩余资源足够的时候可以与应用同主机,降低网络延时);
  • 双实例 + keepalived(单实例挂掉 = 全站 500);
  • 变更前记录 env.php 备份与 SHOW GLOBAL STATUS 基线。

4.3 备份

cp -a /data/wwwroot/new/app/etc/env.php \
      /data/backup/opt-$(date +%Y%m%d)/env.php.pre-proxysql
sha256sum /data/wwwroot/new/app/etc/env.php

5. 安装 ProxySQL

以 TencentOS / RHEL 系为例(2.6.x):

# 1) 仓库
cat > /etc/yum.repos.d/proxysql.repo <<'EOF'
[proxysql_repo]
name=ProxySQL
baseurl=https://repo.proxysql.com/ProxySQL/proxysql-2.6.x/almalinux/9/
gpgcheck=0
enabled=1
EOF

# 2) 安装
dnf install -y proxysql

# 3) 目录与权限(ProxySQL 默认以 proxysql 用户运行)
mkdir -p /var/lib/proxysql /var/log/proxysql
chown -R proxysql:proxysql /var/lib/proxysql /var/log/proxysql

# 4) 启动
systemctl enable --now proxysql
ss -lntp | grep -E '6032|6033'

端口说明:

端口 用途 暴露范围
6033 业务入口(Magento 连这里) 内网
6032 管理接口(用 mysql 客户端连) 仅 127.0.0.1
6030 (可选)内部集群通信 仅内网

管理接口连接:

mysql -uadmin -padmin -h127.0.0.1 -P6032 --prompt='ProxySQL> '

首次登录后立刻改掉默认 admin/admin。


6. 后端定义:主库 / 从库 / 健康检查

6.1 登记后端

INSERT INTO mysql_servers(hostgroup_id, hostname, port, weight, max_connections, max_replication_lag, comment)
VALUES
  (10, '172.26.0.10', 3306, 1, 500, 0, 'master'),
  (20, '<replica_ip>', 3306, 1, 500, 5, 'replica');

LOAD MYSQL SERVERS TO RUNTIME;
SAVE MYSQL SERVERS TO DISK;
  • hostgroup 10 = writer,hostgroup 20 = reader;
  • max_replication_lag=5:从库延迟超过 5 秒,ProxySQL 自动把它从 reader 组摘除,流量回落主库(这是最重要的安全阀);
  • weight 在多从库时用于负载均衡(该能力 Magento 原生模块不具备,是 ProxySQL 的优势)。

6.2 自动识别主从(强烈建议)

INSERT INTO mysql_replication_hostgroups(writer_hostgroup, reader_hostgroup, check_type, comment)
VALUES (10, 20, 'read_only', 'giztop ce');

LOAD MYSQL SERVERS TO RUNTIME;
SAVE MYSQL SERVERS TO DISK;

原理:ProxySQL 周期性执行 SELECT @@read_only,0 判为 writer、1 判为 reader。这样即使有人把地址填错,也能被 read_only 值纠正(或至少暴露)。

6.3 健康检查账号

SET mysql-monitor_username='monitor_user';
SET mysql-monitor_password='<pwd>';
SET mysql-monitor_connect_interval=2000;
SET mysql-monitor_ping_interval=1000;
SET mysql-monitor_replication_lag_interval=2000;
LOAD MYSQL VARIABLES TO RUNTIME;
SAVE MYSQL VARIABLES TO DISK;

监控账号只需:USAGE(能连)+ 能执行 SELECT @@read_only 与 SHOW REPLICA STATUS(后者需 REPLICATION CLIENT)。

验证:

SELECT * FROM monitor.mysql_server_connect_log ORDER BY time_start_us DESC LIMIT 6;
SELECT * FROM monitor.mysql_server_ping_log   ORDER BY time_start_us DESC LIMIT 6;
SELECT * FROM runtime_mysql_replication_hostgroups;

7. 用户与连接管理

7.1 定义业务用户

INSERT INTO mysql_users(username, password, default_hostgroup, transaction_persistent,
                        max_connections, active, comment)
VALUES
  ('giztop_live', '<pwd>', 10, 1, 300, 1, 'frontend'),
  ('giztop_admin','<pwd>', 10, 1, 50,  1, 'admin/backoffice -> always master');

LOAD MYSQL USERS TO RUNTIME;
SAVE MYSQL USERS TO DISK;

要点:

  • transaction_persistent=1 是必开项。开启后,一个连接只要开过事务,事务内后续所有语句都留在该 hostgroup,避免"事务里读到事务外的旧值"。
  • 后台/结算建议用独立账号并固定 default_hostgroup=10,彻底规避写后读。
  • max_connections 按 PHP-FPM 的 pm.max_children × 1.2 估算,不要沿用 MySQL 的 4500。

7.2 关于 multiplexing(连接多路复用)

ProxySQL 默认会尝试把多条客户端连接复用到一个后端连接上。Magento 场景建议关闭,原因:

触发条件 Magento 是否常见
显式事务 :white_check_mark: 非常常见(下单、库存扣减)
临时表 :white_check_mark: 每个分类页 search_tmp_*
会话变量 :white_check_mark: 连接时 SET NAMES utf8mb4 COLLATE utf8mb4_general_ci(Mysql.php:84)
持有锁 :white_check_mark:

任何一条成立都会让该连接退出多路复用。与其让行为随场景漂移,不如显式关闭:

-- 按用户关闭(推荐,影响面可控)
UPDATE mysql_users SET multiplex = 0 WHERE username IN ('giztop_live','giztop_admin');
LOAD MYSQL USERS TO RUNTIME; SAVE MYSQL USERS TO DISK;

-- 或全局关闭
SET mysql-multiplexing=false;
LOAD MYSQL VARIABLES TO RUNTIME; SAVE MYSQL VARIABLES TO DISK;

关闭后连接数会上升,需同步调大 max_connections 与 MySQL 侧 max_connections。

7.3 字符集一致性

ProxySQL 与 MySQL 的默认字符集必须和 Magento 一致,否则会出现中文乱码或隐式转换:

SET mysql-default_charset='utf8mb4';
SET mysql-default_collation_connection='utf8mb4_general_ci';
LOAD MYSQL VARIABLES TO RUNTIME; SAVE MYSQL VARIABLES TO DISK;

8. 路由规则:核心设计

8.1 规则匹配顺序

mysql_query_rules 按 rule_id 升序匹配,apply=1 表示命中即停止。因此:

rule_id 10–19  :强制主库(最高优先级)
rule_id 30–39  :临时表整组(必须同 hostgroup)
rule_id 40–49  :目录页只读白名单
rule_id 90     :兜底(默认主库)

8.2 强制主库(必须写在最前)

INSERT INTO mysql_query_rules(rule_id, active, match_pattern, destination_hostgroup, apply, comment) VALUES
 (10, 1, '(?i)^SELECT .* FOR UPDATE',                       10, 1, 'lock read'),
 (11, 1, '(?i)^SELECT .* LOCK IN SHARE MODE',               10, 1, 'shared lock'),
 (12, 1, '(?i)LAST_INSERT_ID\\(\\)',                         10, 1, 'write-after-read'),
 (13, 1, '(?i)^(INSERT|UPDATE|DELETE|REPLACE)',              10, 1, 'all writes'),
 (14, 1, '(?i)^SELECT .*catalog_compare_item',               10, 1, 'compare state: 写后立即读'),
 (15, 1, '(?i)^SELECT .* (quote|sales_order|customer_entity|inventory_reservation|checkout)', 10, 1, 'transactional tables');

规则 13 是保险:即便白名单写错,写语句永远去主库。

8.3 临时表整组(最容易踩的坑)

Magento 的 Magento\Framework\Search\Adapter\Mysql\TemporaryStorage 每个分类页都会:

CREATE TEMPORARY TABLE search_tmp_xxxx (entity_id INT PRIMARY KEY, score DECIMAL(32,16)) ENGINE=MEMORY;
INSERT INTO search_tmp_xxxx (entity_id, score) VALUES (...);
SELECT ... FROM catalog_product_entity AS e INNER JOIN search_tmp_xxxx AS search_result ON e.entity_id = search_result.entity_id;
DROP TEMPORARY TABLE ...;   -- 连接归还时

临时表是 session 级,跨连接不可见。若建表在主库、查询被路由到从库,直接报:

ERROR 1146 (42S02): Table 'giztop_live.search_tmp_xxxx' doesn't exist

处理原则:整组四条语句必须在同一个 hostgroup。

INSERT INTO mysql_query_rules(rule_id, active, match_pattern, destination_hostgroup, apply, comment) VALUES
 (30, 1, '(?i)^(CREATE|DROP) TEMPORARY TABLE .*search_tmp_', 20, 1, 'temp table ddl'),
 (31, 1, '(?i)^INSERT\\s+INTO\\s+`?search_tmp_',              20, 1, 'temp table insert'),
 (32, 1, '(?i)^SELECT .*search_tmp_',                        20, 1, 'temp table read');

放在 hostgroup 20(从库)是安全的:临时表内容来自 OpenSearch,与主从复制无关;从库本地建 MEMORY 表完全可行。

保守做法:若你想先只切"纯读"而不动临时表,就把这三条改成 10(主库),目录页的 SELECT 也钉主库——但那样就没有分流收益了。

8.4 目录页只读白名单

INSERT INTO mysql_query_rules(rule_id, active, match_pattern, destination_hostgroup, apply, comment) VALUES
 (40, 1, '(?i)^SELECT .*FROM\\s+`?(catalog_product_entity|catalog_product_index|catalog_category_|cataloginventory_stock_status|cms_|url_rewrite)', 20, 1, 'catalog read');

8.5 兜底

INSERT INTO mysql_query_rules(rule_id, active, match_pattern, destination_hostgroup, apply, comment) VALUES
 (90, 1, '^SELECT', 10, 0, 'default: select to master (no apply)');

apply=0 表示"设定目的地但继续匹配后续规则",配合 active=1 作为默认值;真正兜底还可依赖 mysql_users.default_hostgroup=10。

8.6 生效与持久化

LOAD MYSQL QUERY RULES TO RUNTIME;
SAVE MYSQL QUERY RULES TO DISK;

8.7 规则调试(上线前必做)

-- 看某条 SQL 会被怎么路由
SELECT * FROM stats_mysql_query_digest WHERE digest_text LIKE '%search_tmp%' ORDER BY count_star DESC LIMIT 5;
-- 命中计数
SELECT rule_id, hits, destination_hostgroup FROM stats_mysql_query_rules ORDER BY hits DESC LIMIT 10;

stats_mysql_query_rules.hits 能直接告诉你"哪条规则真的生效了",这是排除"规则写错但没人发现"的最快方式。


9. Magento 侧接入

9.1 只改一处

app/etc/env.php(不要动 dbname / username / password):

'db' => [
    'connection' => [
        'default' => [
            'host' => '172.26.0.x:6033',   // ← ProxySQL
            'dbname' => 'giztop_live',
            'username' => 'giztop_live',
            'password' => '******',
            'active' => '1',
        ],
    ],
],

9.2 生效

opcache.validate_timestamps=0,改 env.php 后必须:

cd /data/wwwroot/giztopnew
runuser -u www -- php -d memory_limit=-1 bin/magento cache:flush
systemctl restart php-fpm

(cache:flush 清理配置缓存;restart 让新的 env.php 生效并清 opcache。)

9.3 回滚(30 秒)

cp -a /data/backup/opt-YYYYMMDD/env.php.pre-proxysql /data/wwwroot/new/app/etc/env.php
chown www:www /data/wwwroot/new/app/etc/env.php && chmod 600 /data/wwwroot/new/app/etc/env.php
cd /data/wwwroot/new && runuser -u www -- php -d memory_limit=-1 bin/magento cache:flush
systemctl restart php-fpm

10. 灰度、验证与观测

10.1 三阶段灰度

阶段 规则 观察期 通过标准
A 只开 8.2 强制主库 + 8.5 兜底(全部走主库,仅验证代理链路) 1 天 页面 200;stats_mysql_query_digest 有数据;无 1146/1040
B 开 8.4 目录页只读白名单(不含临时表) 1–2 天 目录页正常;从库 QPS 上升;主库 CPU 下降
C 开 8.3 临时表整组到从库 3–7 天 无 1146;Seconds_Behind_Source 稳定 < 1s

10.2 功能验证清单

# 1) 基础页面
for p in / /accessories.html "/accessories.html?cat=106&price=10-20" \
         "/catalogsearch/result/?q=phone" /redmi-17c-4g.html /checkout/cart/; do
  curl -s -o /dev/null -H 'Host: www.new.com' -w "$p -> %{http_code}\n" "http://127.0.0.1:8080$p"
done

# 2) 目录页商品数与价格区间必须与改造前一致(防"优化成空列表")
curl -s -H 'Host: www.new.com' "http://127.0.0.1:8080/accessories.html?cat=106&cb=v$RANDOM" \
 | grep -o 'data-product-id="[0-9]*"' | sort -u | wc -l      # 期望 24

# 3) 临时表请求是否报错(关键)
grep -c "search_tmp" /data/wwwroot/new/var/log/exception.log

10.3 分流效果观测

-- 每个 hostgroup 的吞吐
SELECT hostgroup, COUNT(*) q, SUM(count_star) cnt
FROM stats_mysql_query_digest GROUP BY hostgroup;

-- 连接池状态
SELECT hostgroup, srv_host, status, ConnUsed, ConnFree, Queries
FROM stats_mysql_connection_pool;

主库侧对照:

SHOW GLOBAL STATUS LIKE 'Com_select';   -- 分流后应显著下降
SHOW GLOBAL STATUS LIKE 'Questions';

11. 监控与告警

指标 阈值 含义
Seconds_Behind_Source > 3s 告警,> 5s 自动摘除 复制延迟
stats_mysql_connection_pool.status 出现 OFFLINE_* 后端被摘
mysql_server_ping_log 中的 ping_error 连续 3 次 后端不可达
规则命中 hits 突然归零 规则被覆盖/写错
应用侧 1146 / 1040 错误 > 0 临时表跨库 / 连接数超限

建议把这三条作为每日巡检:

SELECT * FROM monitor.mysql_server_replication_lag_log ORDER BY time_start_us DESC LIMIT 10;
SELECT * FROM stats_mysql_query_rules ORDER BY hits DESC LIMIT 10;
SELECT * FROM stats_mysql_connection_pool;

12. 故障处理与回滚

故障 现象 处置
ProxySQL 进程挂 全站 500(SQLSTATE[HY000] [2002] Connection refused) keepalived 切 VIP;紧急时改 env.php 直连主库 + cache:flush + restart php-fpm
规则导致临时表跨库 目录页 500,日志 Table 'search_tmp_xxx' doesn't exist 停用 8.3 规则(UPDATE ... SET active=0),LOAD TO RUNTIME
从库延迟暴涨 价格/库存显示旧值 等 ProxySQL 自动摘除;或手动 UPDATE mysql_servers SET status='OFFLINE_SOFT' WHERE hostgroup_id=20
读到"刚写的没生效" 加购后购物车空、对比列表空 把该表相关 SELECT 加入 8.2 强制主库;后台账号固定主库
连接数打满 Too many connections 关闭 multiplex 后连接数上升,调高 max_connections 与 MySQL max_connections

回滚优先级:先改 env.php 直连主库(30 秒),再修规则。不要指望先修规则——用户在看 500。


13. 常见问题(FAQ)

Q1:为什么不能用"所有 SELECT 都走从库"?
Magento 的 SELECT 里混着会话态读取(SELECT @@…、GET_LOCK)、临时表读取、事务内读取。一律走从库会导致:读不到自己的写、临时表不存在、锁语义失效。

Q2:SET NAMES 会不会影响复用?
会。Magento 连接时执行 SET NAMES utf8mb4 COLLATE utf8mb4_general_ci(Mysql.php:84),属于会话变量设置。这就是本文建议显式关闭 multiplexing 的原因。

Q3:Magento 用的是服务端预处理吗?
不是。PDO::ATTR_EMULATE_PREPARES = true(Mysql.php:561),SQL 在 PHP 侧拼装后整条发送。对规则匹配是好事。

Q4:能不能直接写 db.slave_connection?
在社区版不能——没有 Magento_ResourceConnections 模块来实现这套配置(见第 1 章实测)。写了也不会生效,这一点极易误判。

Q5:ProxySQL 的 query cache 能用吗?
不要用。 Magento 已有 Varnish + FPC,再叠一层 SQL 结果缓存会导致难以排查的陈旧数据,且缓存失效逻辑与 Magento 的 tag 机制不兼容。

Q6:临时表为什么不放主库、只把查询放从库?
因为临时表是 session 级对象,跨连接不可见。必须整组同 hostgroup。

Q7:从库需要和主库一样的账号权限吗?
需要同名账号,且只需 SELECT(只读)。应用账号若在从库有写权限,务必收回,防止误写。


14. 本项目适配说明(实测数据,2026-11-17)

事实 数值 对方案的影响
主库 QPS(14h 均值) Com_select ≈ 3,390/s 分流收益的主要来源
库总大小 2.25 GB 从库可全量常驻内存,分流后不会变成 I/O 瓶颈
主库 buffer pool 12 GB(空闲页 9.7 GB,命中率 99.9998%) 主库 CPU 不是内存/IO 问题,分流纯为分摊 CPU
目录页每请求 SELECT 265–350 条 分流后主库压力下降的主因
目录页每请求 INSERT 3.5 条,全部是 search_tmp_* 临时表 目录页近乎纯读,适合走从库(须整组钉同一 hostgroup)
catalog_compare_item 174 行 compare 走从库收益≈0,风险=写后读,留在主库
Magento 产品版本 magento/project-community-edition 2.4.9 无原生读写分离,ProxySQL 是唯一零代码路径
只读实例 尚未确认(172.26.0.10 实测 read_only=0,是主库) 上线前置条件,必须先拿到真实只读地址

本项目推荐灰度顺序:先只切"报表 / 后台 grid / 导出 / sitemap"这类纯读重查询(社区版后台与前台共用连接,靠 digest 规则区分),观察 3 天,再放开目录页白名单。


15. 附录

15.1 一次性初始化脚本

-- 在 ProxySQL 管理口执行
INSERT INTO mysql_servers(hostgroup_id,hostname,port,weight,max_connections,max_replication_lag,comment) VALUES
 (10,'172.26.0.10',3306,1,500,0,'master'),
 (20,'<replica_ip>',3306,1,500,5,'replica');

INSERT INTO mysql_replication_hostgroups(writer_hostgroup,reader_hostgroup,check_type,comment)
VALUES (10,20,'read_only','giztop');

INSERT INTO mysql_users(username,password,default_hostgroup,transaction_persistent,multiplex,max_connections,active) VALUES
 ('giztop_live','<pwd>',10,1,0,300,1),
 ('giztop_admin','<pwd>',10,1,0,50,1);

INSERT INTO mysql_query_rules(rule_id,active,match_pattern,destination_hostgroup,apply,comment) VALUES
 (10,1,'(?i)^SELECT .* FOR UPDATE',10,1,'lock'),
 (11,1,'(?i)^SELECT .* LOCK IN SHARE MODE',10,1,'shared lock'),
 (12,1,'(?i)LAST_INSERT_ID\\(\\)',10,1,'last insert'),
 (13,1,'(?i)^(INSERT|UPDATE|DELETE|REPLACE)',10,1,'writes'),
 (14,1,'(?i)^SELECT .*catalog_compare_item',10,1,'compare'),
 (15,1,'(?i)^SELECT .* (quote|sales_order|customer_entity|inventory_reservation|checkout)',10,1,'tx tables'),
 (30,1,'(?i)^(CREATE|DROP) TEMPORARY TABLE .*search_tmp_',20,1,'tmp ddl'),
 (31,1,'(?i)^INSERT\\s+INTO\\s+`?search_tmp_',20,1,'tmp insert'),
 (32,1,'(?i)^SELECT .*search_tmp_',20,1,'tmp read'),
 (40,1,'(?i)^SELECT .*FROM\\s+`?(catalog_product_entity|catalog_product_index|catalog_category_|cataloginventory_stock_status|cms_|url_rewrite)',20,1,'catalog read'),
 (90,1,'^SELECT',10,0,'default');

SET mysql-monitor_username='monitor_user';
SET mysql-monitor_password='<pwd>';
SET mysql-default_charset='utf8mb4';
SET mysql-multiplexing=false;

LOAD MYSQL SERVERS TO RUNTIME;   SAVE MYSQL SERVERS TO DISK;
LOAD MYSQL USERS TO RUNTIME;     SAVE MYSQL USERS TO DISK;
LOAD MYSQL QUERY RULES TO RUNTIME; SAVE MYSQL QUERY RULES TO DISK;
LOAD MYSQL VARIABLES TO RUNTIME; SAVE MYSQL VARIABLES TO DISK;

15.2 上线前检查清单

  • 只读实例 read_only=1、server_id 与主库不同
  • 从库 Seconds_Behind_Source 稳定 < 1s
  • 应用账号在从库存在且仅 SELECT
  • ProxySQL 双实例 + VIP
  • 管理口仅监听 127.0.0.1,默认口令已改
  • mysql_users.transaction_persistent=1、multiplex=0
  • 规则 13(写语句强制主库)已生效
  • 临时表三条规则 hostgroup 一致
  • env.php 已备份、sha256 已记录
  • 回滚命令已演练(改回直连 + cache:flush + restart)