关键是对齐影响SQL行为的核心配置：sql_mode、character_set_server/collation_server、time_zone、binlog开关及innodb_flush_log_at_trx_commit，而非复制全部参数；Docker本地开发应挂载自定义my-dev.cnf并严格匹配生产值，避免因时区、字符集、严格模式等差异导致行为不一致。
做不到「完全一致」，但能无限接近——关键不是复制所有参数，而是对齐影响行为的核心配置项。
为什么不能完全一致
生产环境有硬件差异（CPU核数、内存大小、SSD/NVMe I/O能力）、网络拓扑（VIP、MHA管理节点、跨机房延迟）、安全策略（firewalld规则、SELinux上下文、auditd日志）和运维集成（备份脚本路径、监控Agent采集点、日志轮转策略）。这些没法也不该在本地复刻。
真正需要对齐的只有三类东西：sql_mode、character_set_server/collation_server、time_zone，以及是否启用binlog和innodb_flush_log_at_trx_commit——它们直接决定SQL执行结果、字符显示、时区转换和事务持久性。
用 Docker 启动一个「语义等价」的实例
别用 mysql:8.0 默认镜像直接跑，它启用了严格模式、innodb_flush_log_at_trx_commit = 1、skip-log-bin 被注释掉（即 binlog 默认开启），跟多数开发诉求冲突。
- 拉取镜像后，挂载自定义配置文件：
my-dev.cnf，内容必须包含：
[mysqld] sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION" character_set_server = utf8mb4 collation_server = utf8mb4_unicode_ci time_zone = "+00:00" skip-log-bin innodb_flush_log_at_trx_commit = 2
注意：sql_mode 值要从生产库执行 SELECT @@sql_mode 拿到，不能手写；time_zone 必须跟生产一致（比如 "Asia/Shanghai"），否则 NOW()、CONVERT_TZ() 行为不同。
启动命令示例：
docker run -d \ --name mysql-dev \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=dev123 \ -e MYSQL_DATABASE=myapp \ -v $(pwd)/mysql-data:/var/lib/mysql \ -v $(pwd)/my-dev.cnf:/etc/mysql/conf.d/my.cnf \ -d mysql:8.0
应用连接层必须忽略 host/port 差异
硬编码 localhost:3306 或在代码里写 if-else 切换数据库地址，是环境不一致的根源。正确做法是：
- 所有环境统一读取环境变量：
DB_HOST、DB_PORT、DB_USER、DB_PASS - 本地开发时设
DB_HOST=localhost；K8s 生产环境通过 Service DNS 名（如mysql-primary.default.svc.cluster.local）；物理机部署则填 VIP 或真实 IP - 连接字符串构造逻辑里，**绝不拼接字符串**，用标准 URL 解析器（如 Go 的
url.Parse、Python 的urllib.parse.urlparse）处理，避免因端口缺失或特殊字符导致解析失败
容易被忽略的三个细节
secure_file_priv 在本地通常为空，允许 LOAD DATA INFILE '/tmp/x.csv'；但生产环境一般设为具体目录（如 /var/lib/mysql-files/），如果代码里用了这个语句，本地能跑通，上线就报错 ERROR 1290 (HY000): The MySQL server is running with the --secure-file-priv option...。
MySQL 8.0 默认认证插件是 caching_sha2_password，而很多旧客户端（如某些 Python MySQLdb 版本、PHP 7.4 以下 mysqli）不支持——本地开发用新驱动没问题，但生产若混用老服务，就会连不上。要么统一升级客户端，要么建用户时显式指定：CREATE USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';。
最后，max_connections 这种参数本地设 100 就够，但若应用里写了连接池最大值为 200，而没做兜底校验，上线后可能因连接数超限直接拒绝新请求——这类边界值差异，必须在 CI 阶段用真实配置跑集成测试暴露出来。
