问题复现：那些让人抓狂的报错瞬间
作为 N8N大学 的首席主编，笔者在后台和社群里见过太多同学在配置 MySQL 连接时“翻车”。你是不是也遇到过这种情况：满怀信心地拖拽出一个 MySQL 节点，填好参数，点击执行，结果屏幕上跳出刺眼的红色错误提示。
最常见的报错代码通常长这样：
connect ECONNREFUSED 127.0.0.1:3306（连接被拒绝）getaddrinfo ENOTFOUND mysql（找不到主机）Client does not support authentication protocol requested by server（认证协议不支持）Connection timed out（连接超时）
这些报错背后，其实隐藏着从驱动版本到网络防火墙的多重陷阱。别急，这篇指南就是你的“排雷手册”。
原因分析：为什么 n8n 连不上 MySQL？
用大白话来说，n8n 和 MySQL 的对话就像打电话。如果 n8n 拿起电话（发起请求），但 MySQL 没接（端口不通），或者 n8n 说的方言 MySQL 听不懂（驱动/认证协议不匹配），连接就会失败。
通常原因归结为三类：
- 网络不通：n8n 所在的服务器根本找不到 MySQL 的地址，或者被防火墙拦截了。
- 驱动/认证不匹配：MySQL 8.0 默认使用了新的加密方式，而旧版的 n8n 驱动可能不支持。
- 配置错误：Host、Port 填错了，或者数据库名称拼写错误。
解决方案一：搞定网络与防火墙（最常见坑）
90% 的连接问题其实都出在网络层面。如果你在 Docker 中运行 n8n，这个问题尤为突出。
1. 检查 Host 填写规则
这是新手最容易犯的错。你需要根据 n8n 和 MySQL 的部署位置来决定填写什么：
- 场景 A：n8n 和 MySQL 在同一台服务器，且都是 Docker 容器
不要填localhost或127.0.0.1！请填 MySQL 容器的服务名（例如mysql或db）。确保两个容器在同一个 Docker Network 下。 - 场景 B：n8n 在 Docker，MySQL 在宿主机（外部）
不要填localhost！请填宿主机的局域网 IP（例如192.168.1.100），并且确保 MySQL 监听在0.0.0.0而不是127.0.0.1。
2. 防火墙放行
无论是云服务器的 安全组（Security Group） 还是服务器内部的防火墙（如 ufw 或 firewalld），必须确保 3306 端口是对外开放的。
避坑技巧： 如果你在使用云服务器（阿里云/腾讯云/AWS），仅仅在服务器内部开启防火墙是不够的，必须去云控制台的安全组规则里放行 3306 端口入方向。
解决方案二：解决 MySQL 8.0 认证协议问题
如果你的网络是通的（telnet ip 3306 能连上），但依然报 Client does not support authentication protocol，那就是认证协议的问题。
MySQL 8.0+ 默认使用 caching_sha2_password 插件进行加密，而 n8n 使用的 Node.js 连接库在某些版本可能还不完全支持，或者需要额外配置。
解决办法（二选一）：
- 升级 n8n： 建议将 n8n 升级到最新版本，新版驱动通常已适配。
- 修改 MySQL 用户认证方式（推荐）： 登录你的 MySQL 数据库，执行以下 SQL 语句，将用户的认证插件改回传统的
mysql_native_password。
ALTER USER '你的用户名'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;
修改后，在 n8n 的 MySQL 节点配置中重新测试连接即可。
解决方案三：检查 n8n 节点配置细节
排除了网络和驱动，最后我们来检查 n8n 节点本身的配置细节。
1. SSL 配置
很多云数据库（如阿里云 RDS、AWS RDS）强制要求 SSL 连接。如果你在 n8n 的 MySQL 节点设置中看到 SSL 选项：
- 如果是自建数据库且未配置 SSL，确保 SSL 选项设为
None或不勾选。 - 如果是云数据库，通常需要下载 CA 证书（.pem 文件），并在节点中填入 CA 文件路径或内容。
2. 连接超时设置
如果你的网络环境较差，或者数据库响应慢，默认的连接超时时间可能太短。在 n8n 的 MySQL 节点配置中，可以尝试增加 Connect Timeout 的值（例如设置为 10000 毫秒）。
3. 数据库名称与端口
这听起来很基础，但请再确认一次：
- Port：MySQL 默认是
3306，但有些自定义安装可能改成了3307。 - Database：确保填写的是具体的数据库名，而不是表名。
FAQ：你可能还想问
Q1: 我使用的是 n8n Cloud 版，能连接本地的 MySQL 吗？
A: 很遗憾，n8n Cloud（SaaS 版）运行在 n8n 的服务器上，无法直接访问你本地内网的数据库。你需要将 MySQL 暴露到公网（注意安全），或者使用 N8N大学 推荐的方案：使用 Workato 或 Zapier 这种支持本地代理的工具，或者坚持使用 n8n 自托管版本（Self-hosted）。
Q2: 连接 MariaDB 有区别吗？
A: MariaDB 是 MySQL 的分支，n8n 的 MySQL 节点通常兼容 MariaDB。如果遇到问题，可以尝试使用 MariaDB 节点（如果 n8n 版本提供了该节点），或者参照上述 MySQL 8.0 的认证方式处理。
Q3: 报错 "Too many connections" 怎么办？
A: 这说明 n8n 建立了太多未关闭的连接。检查你的工作流逻辑，确保每次执行完数据库操作后，连接能正常释放。或者在 MySQL 服务端调大 max_connections 参数。
总结与资源
排查 n8n 连接 MySQL 的问题，其实就是一个由简入繁的过程：先看网络通不通（IP/端口/防火墙），再看协议对不对（驱动/认证方式），最后看配置细不细（SSL/超时）。
按照 N8N大学 这篇指南一步步走，99% 的连接报错都能被解决。如果还有那剩下的 1%，欢迎在 N8N大学 社区发帖，带上你的报错截图，笔者会亲自帮你诊断。
相关资源推荐：
- N8N大学 - 《Docker 网络配置实战》
- N8N官方文档 - MySQL Node Configuration
