在 N8N大学 的日常交流群里，笔者经常看到有新手朋友抱怨：“我的 n8n 跑得好好的，为啥一查 MySQL 节点的日志，全是天书？一堆问号或者奇怪的符号，根本没法调试！”
这种感觉就像你明明把信寄出去了，结果对方收到的却是一张白纸。这种“乱码”问题，通常不是 n8N 本身的锅，而是数据库环境、连接配置或编码格式的“三重门”没对齐。
今天，笔者就以“学长”的身份，带你硬核排查这 3 个关键点。不讲虚的，只给干货。
关键点一：检查 MySQL 字符集与排序规则
乱码的根源，90% 都在于字符集不匹配。MySQL 服务器、数据库、表甚至字段，每一层都有自己的编码设定。
如果你的 MySQL 服务器默认编码是 latin1，而你在 n8n 里存入的是 UTF-8 的中文数据，数据入库时就会被错误转码，导致日志里出现乱码。
排查步骤：
- 登录你的 MySQL 数据库，执行以下命令查看全局字符集：
SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';
重点关注 character_set_database 和 character_set_server。理想状态下，它们应该都是 utf8mb4（支持 Emoji 和生僻字），而不是 latin1 或 utf8。
关键点二：N8N MySQL 节点的连接配置
即便数据库本身是 UTF-8，如果 n8n 的“信使”（MySQL 节点）在连接时没有声明正确的编码，同样会乱码。这通常发生在建立连接的初始阶段。
在 n8n 中，当你配置 MySQL 节点的“连接参数”时，不要只填 IP 和密码。点击“Additional Fields”（额外字段），查看是否有字符集设置。
实操建议：
如果你的 n8n 版本支持（较新版本），请在连接参数中显式添加：
charset:UTF8MB4collation:utf8mb4_unicode_ci
如果你的 n8n 节点没有直接提供这些选项，你可能需要在“Connect String”（连接字符串）中手动追加参数，例如：
mysql://user:pass@host:3306/db?charset=utf8mb4
这能确保 n8n 在握手的第一时间就告诉 MySQL：“嘿，我们要用 UTF-8 交流。”
关键点三：Docker 环境的时区与编码干扰
很多 N8N大学 的读者是使用 Docker 部署 n8n 的。这里有一个经典的坑：容器内部的系统编码与宿主机不一致。
如果你的 n8n 是跑在 Docker 里的，而 MySQL 节点的日志出现乱码，很可能是容器内的 LANG 或 LC_ALL 环境变量没设置对。虽然 n8n 主要通过 Node.js 驱动，但底层系统调用仍受环境影响。
解决方案：
在你的 docker-compose.yml 文件中，为 n8n 服务显式设置环境变量：
environment: - LANG=C.UTF-8 - LC_ALL=C.UTF-8
这能强制容器使用 UTF-8 编码处理日志输出，避免底层的字节流被错误解析。改完后记得重启容器：
docker-compose restart
进阶排查：如果以上都没问题？
当你排除了上述三点，乱码依然存在，那就要看看是不是数据本身的问题了。
有时候，数据在存入数据库之前就已经“脏”了。比如前端传来的数据本身就不是 UTF-8，或者 n8n 的上游节点（如 HTTP Request）接收到的响应编码不是 UTF-8。
笔者的调试技巧：
在 MySQL 节点之前，插入一个 Set 节点或 Function 节点。打印出你要写入的数据内容，确认在进入 MySQL 节点前，数据是正常的。如果这里就乱了，那是上游的问题；如果这里是正常的，进入 MySQL 后乱了，那就是连接或数据库的问题。
FAQ 常见问题解答
1. 为什么我的日志在 n8n 界面里是正常的，导出来却乱码？
这通常是因为导出日志的工具（如终端、文本编辑器）编码不匹配。确保你的终端模拟器（如 iTerm2, Windows Terminal）设置为 UTF-8 编码。
2. n8n 支持 GBK 编码的 MySQL 数据库吗？
支持，但不推荐。如果你必须连接 GBK 编码的旧库，请在连接字符串中明确指定 charset=GBK。但强烈建议将数据库迁移至 UTF-8，以避免未来更多的兼容性问题。
3. 修改了 MySQL 配置文件（my.cnf）后需要重启数据库吗？
是的，修改 character_set_server 等全局参数通常需要重启 MySQL 服务才能生效。如果无法重启，可以使用 SET GLOBAL 命令临时修改，但新连接才会生效。
总结与资源
MySQL 节点日志乱码，本质上是“编码协议”没对齐。记住 N8N大学 的排查口诀：一看库表字符集，二看连接参数串，三看 Docker 环境变。
只要坚持使用 utf8mb4 这个黄金标准，99% 的乱码问题都能迎刃而解。
如果你还有其他 n8n 自动化中的“疑难杂症”，欢迎访问 N8N大学 (n8ndx.com)，这里有更多硬核的实战教程等你来翻牌。
