MySQL连接失败主因是网络或服务问题,需检查telnet/nc连通性、安全组、host配置(用127.0.0.1而非localhost)、charset='utf8mb4'及防火墙;CSV导出乱码须全程用utf-8-sig编码;schedule不适用于生产,应改用cron或Windows任务计划;查大表须用SSCursor流式读取+fetchmany分批处理。

连接 MySQL 时 pymysql.connect() 报 OperationalError: (2003, "Can't connect to MySQL server")
绝大多数连不上,不是密码错,而是网络或服务没起来。先确认 MySQL 实例在目标机器上真实可访问:telnet host port 或 nc -zv host port;如果本地开发连远程库,注意云厂商安全组是否放行了 3306(或自定义端口)。
常见疏漏点:
-
host写成'localhost'→ 实际走 socket 连接,不走 TCP;换成'127.0.0.1'强制走 TCP,和远程连接行为一致 - 没传
charset='utf8mb4'→ 中文字段查出来是乱码或报UnicodeDecodeError,尤其含 emoji 的场景必须设 - 忘记关防火墙(如 CentOS 的
firewalld)或 MySQL 的bind-address配置锁死了只监听本地
查询结果导出为 CSV 时中文乱码或字段错位
本质是编码链路断在某环:MySQL 连接、Python 字符串、文件写入、Excel 打开方式。最稳做法是全程用 utf-8-sig 编码写文件,让 Excel 能自动识别 BOM。
关键操作:
立即学习“Python免费学习笔记(深入)”;
- 连接时加参数:
charset='utf8mb4',且确保数据库/表字符集是utf8mb4_unicode_ci或类似 - 用
csv.writer写文件时,打开文件必须用encoding='utf-8-sig',不是utf-8 - 别用
pandas.to_csv()默认设置——它默认不写 BOM,Excel 打开中文列名仍可能乱码;显式加encoding='utf-8-sig'
示例片段:
with open('report.csv', 'w', newline='', encoding='utf-8-sig') as f:
writer = csv.writer(f)
writer.writerow(['订单号', '用户昵称', '金额'])
writer.writerows(rows)
用 schedule 库跑定时任务,程序退出后任务就停了
schedule 本身不守护进程,只是个“闹钟调度器”,主线程一结束,所有 pending 任务全丢。它适合脚本调试,不适合生产部署。
真正能长期跑的方案只有两个方向:
- Linux 下扔进
cron:写好 Python 脚本(含完整连接、查询、导出逻辑),用crontab -e加规则,比如每天 9 点跑:0 9 * * * /usr/bin/python3 /path/to/report.py - Windows 下用任务计划程序,触发器选“按预定计划”,操作选“启动程序”指向
python.exe,参数填脚本路径 - 坚决别用
while True: schedule.run_pending(); time.sleep(1)放后台——没异常捕获、没日志、挂了都不知道
查大表时内存爆掉或超时,pymysql 直接卡死
默认 pymysql 把整张结果集一次性 load 到内存,百万级数据秒变 OOM。必须改用游标流式读取 + 分批处理。
正确姿势:
- 创建连接时加
cursorclass=pymysql.cursors.SSCursor(ServerSideCursor),让 MySQL 服务端逐批吐数据 - 别用
cursor.fetchall(),改用cursor.fetchmany(size=1000)控制每次取多少行 - 导出 CSV 时边查边写,不要把全部结果存成 list 再 dump
- SQL 里加
LIMIT和OFFSET不解决根本问题——深分页照样慢;优先考虑用时间范围或 ID 区间分片,比如WHERE create_time BETWEEN %s AND %s
复杂点在于:流式查询下没法直接知道总行数,如果报告需要“共查询 XXX 条”,得先单独跑 SELECT COUNT(*),但要注意这个 count 本身也可能慢——这时候就得评估是否真有必要显示总数。


















