feat: 新增中间件文档和内部通讯技能

新增中间件相关文档包括 RocketMQ、Nacos、PowerJob 的部署指南和故障分析文档，完善 Keepalived 和 MySQL 的文档内容。新增内部通讯技能模板和示例文件，包括 3P更新、公司通讯、FAQ回答等格式指南。优化服务文档结构，补充 FIX 引擎高可用架构说明。新增中间件综合指南，详细说明高可用部署方案和灾备转换原理。新增 RocketMQ 5.3.2 集群部署文档，包含 Controller 模式详解和详细配置说明。新增 Nacos 和 PowerJob 部署文档，补充服务依赖和关键配置。更新 MySQL 故障分析文档，优化复制冲突解决流程。新增内部通讯技能模板文件，规范公司内部通讯格式。 docs: 补充服务文档和中间件 TODO 列表新增 g3fo-exchange-fix-engine-service 服务文档，详细说明服务职责和关键配置。新增中间件 TODO 列表，跟踪待补充的文档内容。更新 Keepalived 部署文档，新增主库抢占前置检查脚本和配置说明。优化中间件文档结构，补充常见问题和性能优化建议。 style: 统一文档格式和代码块样式统一所有文档的代码块格式和标题层级。优化表格显示样式，增强可读性。规范环境变量和配置项的显示方式。调整文档结构，确保逻辑清晰。修复部分拼写错误和格式问题。 chore: 新增 LICENSE 文件新增内部通讯技能的 Apache 2.0 LICENSE 文件。补充文档版权信息。更新文件头部的元数据描述。规范文件命名和目录结构。
2026-01-23 17:15:16 +08:00
parent 50455cc8c6
commit 3525aee49e
16 changed files with 2368 additions and 26 deletions
@@ -4,24 +4,49 @@
 > 1. **强制参数**: 所有 `docker exec` 命令必须包含 `-h127.0.0.1` 参数。
 > 2. **双重输出**: 涉及 SQL 操作时，必须同时输出 `Docker 执行命令` 和 `纯 SQL 脚本`。
 > 3. **默认连接**: 默认使用 `-uroot -pafe123456 -h127.0.0.1`。
+> 4. **排障连贯性**: 诊断复制冲突时，在提供 **A. 查看复制状态概要** 后，**必须紧跟** 提供 **B. 自动提取错误详情** 脚本，以便用户直接获取修复建议。

-## 1. 复制冲突解决（主键/唯一键重复）
+## 1. 复制冲突解决（主键/唯一键重复或记录缺失）

 ### 1.1 快速定位冲突信息
-提取冲突 GTID、表、值（直接执行，自动解析错误日志）：
+
+当复制中断时，**必须按顺序执行以下两步**：首先查看概要，然后提取详细错误以获取修复脚本。
+
+**A. 查看复制状态概要:**
+```bash
+# 方式 1: 传统状态查看 (重点关注 Last_SQL_Error)
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SHOW REPLICA STATUS\G" | grep -E "Replica_.*_Running|Last_SQL_Error|Retrieved_Gtid_Set|Executed_Gtid_Set"
+
+# 方式 2: 多线程环境下查看详情 (若启用并行复制，SHOW REPLICA STATUS 只能看到协调线程错误)
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SELECT * FROM performance_schema.replication_applier_status_by_worker WHERE LAST_ERROR_NUMBER > 0\G"
+```
+
+**B. 自动提取错误详情（支持 1062 重复键 / 1032 记录未找到）:**
+直接在宿主机执行以下脚本，它会自动解析错误日志并生成对应的修复方案：

 ```bash
-grep "Duplicate entry" /data/mysql/logs/mysql_error.log | perl -nle '
-if (/^(\S+).*?transaction\s+'\''([^'\'']+)'\''.*?table\s+([^\s;]+);.*?Duplicate entry\s+'\''([^'\'']+)'\''\s+for\s+key\s+'\''([^'\'']+)'\''/) { 
-  print "\n" . "="x50; 
-  print "时间: $1"; 
-  print "GTID: $2"; 
-  print "表名: $3"; 
-  print "冲突值: $4 (索引: $5)"; 
-  print "\n方案 A (删除冲突行):"; 
-  print "DELETE FROM $3 WHERE [主键列] = \x27$4\x27;"; 
-  print "\n方案 B (跳过此事务):"; 
-  print "STOP REPLICA; SET GTID_NEXT=\x27$2\x27; BEGIN; COMMIT; SET GTID_NEXT=\x27AUTOMATIC\x27; START REPLICA;"; 
+# 提取冲突 GTID、表、冲突值及修复建议
+grep -aE "Duplicate entry|Error_code: 1032" /data/mysql/logs/mysql_error.log | perl -nle '
+if (/^(\S+).*?transaction\s+[\x27"]([^\x27"]+)[\x27"].*?table\s+([^\s;]+);/) {
+  my ($time, $gtid, $table) = ($1, $2, $3);
+  print "\n" . "="x60;
+  print "时间: $time";
+  print "GTID: $gtid";
+  print "表名: $table";
+
+  if (/Duplicate entry\s+[\x27"]([^\x27"]+)[\x27"]\s+for\s+key\s+[\x27"]([^\x27"]+)[\x27"]/) {
+    print "类型: 1062 (主键/唯一键重复)";
+    print "冲突值: $1 (索引: $2)";
+    print "\n方案 A (手动修复 - 删除从库冲突行):";
+    print "DELETE FROM $table WHERE [主键列] = \x27$1\x27;";
+    print "\n方案 B (跳过事务 - 保持从库现状):";
+    print "STOP REPLICA; SET GTID_NEXT=\x27$gtid\x27; BEGIN; COMMIT; SET GTID_NEXT=\x27AUTOMATIC\x27; START REPLICA;";
+  } elsif (/Error_code: 1032|HA_ERR_KEY_NOT_FOUND/) {
+    print "类型: 1032 (记录未找到 - 通常是 Delete/Update 目标不存在)";
+    print "说明: 目标行在从库已不存在，Delete 操作已实质生效。";
+    print "\n方案 A (直接跳过 - 安全):";
+    print "STOP REPLICA; SET GTID_NEXT=\x27$gtid\x27; BEGIN; COMMIT; SET GTID_NEXT=\x27AUTOMATIC\x27; START REPLICA;";
+  }
 }
 '
 ```