docs: 更正 MySQL 版本事实（服务端 8.0.29、目标机必须 8.0）并用 8.0 客户端重导备份；结构与行数双向还原验证 0 差异

zhizhijie

2026-09-13 4c7d6bd5efa91bafbccf75b372a4d6299a56a393

docs: 更正 MySQL 版本事实（服务端 8.0.29、目标机必须 8.0）并用 8.0 客户端重导备份；结构与行数双向还原验证 0 差异

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-13.md

@@ -56,6 +56,13 @@
- è¿˜åŽŸéªŒè¯ï¼šæŠŠå¤‡ä»½é‡Œçš„库名改成临时库 `traffic_audit_vfy` å¯¼å…¥ï¼Œé€è¡¨ `COUNT(*)` ä¸Žæºåº“比对 â€”— **29 å¼ è¡¨ 0 å·®å¼‚**，抽查 `wyc_order_monthly` 2026-08 è¡Œæ•°æ­£ç¡®ï¼ŒéªŒè¯åŽåˆ é™¤ä¸´æ—¶åº“。
- é¡ºå¸¦ç¡®è®¤ï¼šå¦å¤– 3 ä¸ªè„šæœ¬ï¼ˆsql_city_bus/taxi/wyc）没有 `USE` è¯­å¥ï¼Œå¿…é¡» `-D traffic_audit` æ‰§è¡Œï¼›init.sql è‡ªå¸¦å»ºåº“语句可独立执行。


### 10. å¤‡ä»½è¿˜åŽŸçš„版本核查与强验证（复查发现的问题）
- å¤æŸ¥å‘现两个此前表述不准的点：① æœ¬æœº **MySQL æœåŠ¡ç«¯æ˜¯ 8.0.29**（`D:\mysql\mysql-5.7.41-winx64` åªæ˜¯ 5.7 å®¢æˆ·ç«¯å·¥å…·ï¼‰ï¼Œæ˜¨æ™šæŒ‰ã€Œæœ¬æœºæ˜¯ 5.7」写的说明不准确；② 29 å¼ è¡¨çš„排序规则统一为 `utf8mb4_0900_ai_ci`，**目标机必须装 MySQL 8.0，5.7 ä¼šå¯¼å…¥å¤±è´¥**。
- å› æ­¤æ”¹ç”¨ä¸ŽæœåŠ¡ç«¯åŒç‰ˆæœ¬çš„ `C:\Program Files\MySQL\MySQL Server 8.0\bin\mysqldump.exe` é‡æ–°å¯¼å‡ºå¤‡ä»½ `traffic_audit_full_20260913.sql`（45.5 MB）。
- å¼ºéªŒè¯ï¼ˆ8.0 å®¢æˆ·ç«¯ï¼‰ï¼šå¤‡ä»½æ”¹åº“名导入临时库 `traffic_audit_vfy` â†’ è¡¨æ•°é‡ 29=29、表名一致、**逐表 `SHOW CREATE TABLE` ç»“构差异 0**、**逐表 `COUNT(*)` è¡Œæ•°å·®å¼‚ 0**、抽查 `wyc_order_monthly` 2026-08 `order_sum` ä¸€è‡´ â†’ éªŒè¯åŽåˆ é™¤ä¸´æ—¶åº“。
- éƒ¨ç½²è¯´æ˜Žå·²åŒæ­¥æ›´æ­£ï¼ˆçŽ¯å¢ƒè¦æ±‚表、路线 B å‘½ä»¤ä¸Žç‰ˆæœ¬è¯´æ˜Žã€`DROP TABLE` è¦†ç›–警告）。

## äºŒã€æµ‹è¯•ç»“果摘要（详见《功能测试报告》）

| é¡¹ | ç»“æžœ |

 docs/´ò°ü²¿Êð˵Ã÷.md

@@ -17,7 +17,7 @@
| ç»„件 | ç‰ˆæœ¬ | è¯´æ˜Ž |
|------|------|------|
| JDK | 1.8 | éƒ¨ç½²æœºå¿…须；后端编译/运行 |
| MySQL | 5.7 / 8.0 | éƒ¨ç½²æœºå¿…须，库名 `traffic_audit` |
| MySQL | **8.0** | éƒ¨ç½²æœºå¿…须，库名 `traffic_audit`；现网/开发机为 8.0.29，表排序规则是 `utf8mb4_0900_ai_ci`，**目标机装 5.7 ä¼šå¯¼å…¥å¤±è´¥** |
| Maven 3.x / Node.js 14+ | â€” | **只有「在部署机上打包」才需要**；用一键脚本产出的包部署则不需要 |
| Redis | **不需要** | ä»£ç æœªä½¿ç”¨ Redis（旧说明中的 Redis é…ç½®æ˜¯é—留项，可忽略） |
| nginx / IIS | **不需要** | å‰ç«¯å·²å†…嵌进 jar，访问 8090 å³å¯ï¼›è¦å‰åŽç«¯åˆ†ç¦»æ—¶æ‰æ˜¯å¤‡é€‰ |
@@ -88,10 +88,12 @@

#### è·¯çº¿ B：把现网/开发机的数据整套搬过去（推荐，不用跑脚本）

先确认两端 MySQL éƒ½æ˜¯ **8.0**（本库表排序规则为 `utf8mb4_0900_ai_ci`，5.7 ä¸è¯†åˆ«ä¼šå¯¼è‡´å¯¼å…¥å¤±è´¥ï¼‰ï¼Œå¹¶ä¸”**用与服务端同版本的 mysqldump**（不要用 5.7 çš„客户端去导 8.0 æœåŠ¡ç«¯ï¼‰ã€‚

在源机器（本机 MySQL ç«¯å£ç¤ºä¾‹ 3308，按实际改）：

```bash
"D:\mysql\mysql-5.7.41-winx64\bin\mysqldump.exe" ^
"C:\Program Files\MySQL\MySQL Server 8.0\bin\mysqldump.exe" ^
  --host=127.0.0.1 --port=3308 --user=root --password=你的密码 ^
  --default-character-set=utf8mb4 --single-transaction --routines --triggers --events ^
  --databases traffic_audit > traffic_audit_full_YYYYMMDD.sql
@@ -104,9 +106,10 @@
```

- `--databases` ä¼šæŠŠ `CREATE DATABASE` + `USE` ä¸€èµ·å†™è¿›å¤‡ä»½ï¼Œæ‰€ä»¥ç›®æ ‡æœºå™¨**不用先建库、也不用跑那 4 ä¸ªè„šæœ¬**。
- å¤‡ä»½é‡ŒåŒ…含 `sys_user`，所以账号密码与源机器完全一致（本机是 `admin / 123456`），不会被 init.sql é‡ç½®æˆ `admin/admin123`。
- ç‰ˆæœ¬å…¼å®¹ï¼šæœ¬æœºæ˜¯ MySQL 5.7，导到 5.7 æˆ– 8.0 éƒ½å¯ä»¥ï¼›åå‘（8.0 â†’ 5.7）可能因 `utf8mb4_0900_ai_ci` æŽ’序规则失败。
- æœ¬æ¬¡å·²ç”Ÿæˆå¹¶éªŒè¯è¿‡å¤‡ä»½ï¼š`traffic_audit_full_20260913.sql`（45.5 MB，29 å¼ è¡¨å¯¼å…¥åŽé€è¡¨ `COUNT(*)` ä¸Žæºåº“ 0 å·®å¼‚）。
- å¤‡ä»½é‡ŒåŒ…含 `sys_user`，账号密码与源机器完全一致（本机是 `admin / 123456`），不会被重置成 `admin/admin123`。
- âš ï¸ å¤‡ä»½é‡Œæ¯å¼ è¡¨éƒ½å¸¦ `DROP TABLE IF EXISTS`（共 29 å¼ ï¼‰ï¼š**目标库要是已有数据，会被直接覆盖**。请还原到空库，或先自己备份目标库。
- æœ¬æ¬¡å·²ç”Ÿæˆå¹¶**验证过**备份：`traffic_audit_full_20260913.sql`（45.5 MB，8.0.29 å®¢æˆ·ç«¯å¯¼å‡ºï¼‰ã€‚
  éªŒè¯æ–¹å¼ï¼šæŠŠå¤‡ä»½åº“名改成临时库导入，逐表比对 `SHOW CREATE TABLE`（表结构）与 `COUNT(*)`（行数）——**29 å¼ è¡¨ç»“构与行数均 0 å·®å¼‚**，抽查 `wyc_order_monthly` 2026-08 æ•°æ®ä¸€è‡´ï¼ŒéªŒè¯åŽå·²åˆ é™¤ä¸´æ—¶åº“。

> æ³¨æ„ï¼š`docs/` ç›®å½•ï¼ˆæŠ¥è¡¨æ¨¡æ¿ã€æ±‡æ€»å¤§è¡¨æ¯ç‰ˆï¼‰**与数据库无关，无论哪条路线都必须一并拷贝**。