| 项 | 内容 |
|---|---|
| 文档版本 | 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 或读到脏数据) |
目录
- 历史背景:从 Magento 1 到 Magento 2,读写分离能力如何丢失
- 为什么社区版只能用 ProxySQL
- 原理:ProxySQL 在 Magento 请求链路中的位置
- 前置条件与准备
- 安装 ProxySQL
- 后端定义:主库 / 从库 / 健康检查
- 用户与连接管理
- 路由规则:核心设计
- Magento 侧接入
- 灰度、验证与观测
- 监控与告警
- 故障处理与回滚
- 常见问题(FAQ)
- 本项目适配说明(实测数据)
- 附录:完整配置与脚本
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 |
||
| 按业务域拆库(main / checkout / sales) | Split Database 部署方案 | ||
多命名连接(getConnection('sales')) |
Magento\Framework 核心 |
本项目 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')) |
中高(回归面广) | 精细控制 | ||
| ProxySQL 中间件 | 中(新增单点) | 本文方案 | ||
| MySQL Router | 中(功能比 ProxySQL 弱) | 简单场景 |
2. 为什么社区版只能用 ProxySQL
Magento 社区版对数据库的使用有三个特点,决定了外部代理是唯一"零代码"方案:
- 全部走默认连接:
env.php只有db.connection.default,所有 ResourceModel 都用它。 - SQL 由 PHP 拼装:
Zend_Db_Select::assemble()生成完整 SQL 文本再发送。 - 模拟预处理:
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。
三条铁律(后面所有配置都围绕它们):
- 默认走主库,只有白名单 SQL 才去从库;
- 事务内全部留在同一 hostgroup(
transaction_persistent); - 临时表生命周期不能跨 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 是否常见 |
|---|---|
| 显式事务 | |
| 临时表 | search_tmp_* |
| 会话变量 | SET NAMES utf8mb4 COLLATE utf8mb4_general_ci(Mysql.php:84) |
| 持有锁 |
任何一条成立都会让该连接退出多路复用。与其让行为随场景漂移,不如显式关闭:
-- 按用户关闭(推荐,影响面可控)
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)