引言：别让数据库连接成为你自动化的拦路虎
大家好，我是N8N大学的主编。在过去的8年里，我配置过上百个数据库自动化流程。很多新手在接触 n8n 时，第一关往往就卡在了数据库连接上。
MySQL 作为最流行的关系型数据库，与 n8n 的结合本该天衣无缝。但现实是，由于环境配置、权限设置和网络策略的差异，你很容易在连接阶段就遇到各种报错。今天，笔者就来复盘一下我在连接 n8n 与 MySQL 时踩过的 3 个大坑，并附上最直接的解决方案。
坑一：环境变量配置错误导致“连接拒绝”
这是最基础但也最容易被忽视的坑。很多同学在使用 Docker 部署 n8n 时，习惯直接在 UI 界面配置 MySQL 节点，却忽略了 Docker 内部网络与宿主机的隔离。
问题复现
当你配置好 MySQL 节点的主机地址为 localhost 或 127.0.0.1 并点击测试连接时，n8n 可能会报错：getaddrinfo ENOTFOUND localhost 或 connect ECONNREFUSED。
原因分析
如果你的 n8n 运行在 Docker 容器中，而 MySQL 运行在宿主机（或另一个容器）上，容器内的 localhost 指的是容器本身，而不是宿主机。这意味着 n8n 在容器内部找不到 MySQL 服务。
解决方案
不要使用 localhost。请根据你的部署场景选择：
- 场景 A：Docker Compose 部署（推荐）：如果 n8n 和 MySQL 在同一个
docker-compose.yml文件中，使用 服务名（如mysql）作为主机地址。 - 场景 B：Docker 运行，MySQL 在宿主机：使用宿主机的 局域网 IP 地址（如
192.168.1.5），或者在 Docker 运行时添加--network host参数（不推荐生产环境使用）。
笔者提醒：在 n8n 的 MySQL 节点配置中，主机字段切记不要填 localhost，除非你确定 n8n 和 MySQL 运行在同一进程内。
坑二：用户权限不足导致“Access Denied”
解决了网络连通性，接下来就是权限问题。MySQL 的权限管理非常严格，特别是当你使用 root 账号远程连接时，MySQL 8.0+ 默认的加密方式和插件限制会让新手抓狂。
问题复现
报错代码通常为：ER_ACCESS_DENIED_ERROR: Access denied for user 'root'@'xxx' (using password: YES)。明明密码是对的，为什么连不上？
原因分析
主要有两个原因：
1. 权限不足：MySQL 用户表中没有允许该 IP 访问，或者该用户只有 localhost 的访问权限。
2. 加密插件冲突：MySQL 8.0 默认使用 caching_sha2_password 插件，而旧版的 n8n 驱动或某些客户端可能不支持，导致认证失败。
解决方案
请在你的 MySQL 客户端（如 phpMyAdmin 或命令行）中执行以下 SQL 语句：
- 创建专有用户（推荐）：不要使用 root 账号连接生产环境。创建一个新用户并授权。
CREATE USER 'n8n_user'@'%' IDENTIFIED BY '你的强密码'; - 授权访问：赋予该用户对目标数据库的读写权限。
GRANT SELECT, INSERT, UPDATE, DELETE ON 你的数据库名.* TO 'n8n_user'@'%'; - 刷新权限：
FLUSH PRIVILEGES; - 解决加密问题：如果上述操作后仍报错，尝试修改用户加密方式：
ALTER USER 'n8n_user'@'%' IDENTIFIED WITH mysql_native_password BY '你的强密码';
完成上述操作后，在 n8n 的 MySQL 节点中使用新创建的 n8n_user 进行连接即可。
坑三：字段映射与数据类型不匹配
网络和权限都通了，流程跑起来却没报错也没数据？或者报错提示字段错误？这通常是数据类型和映射的问题。
问题复现
你在 n8n 中插入数据，MySQL 表字段是 INT 类型，但 n8n 传过来的是字符串；或者日期格式不对，导致插入失败。报错可能提示 Incorrect integer value 或 Incorrect date value。
原因分析
n8n 是基于 Node.js 的，其数据传输主要依赖 JSON。在 JSON 中，数字和字符串都是基本类型，但 MySQL 对数据类型非常敏感。如果你在 n8n 的 Set 节点或数据输入时没有显式转换类型，MySQL 可能会拒绝执行。
解决方案
在使用 MySQL 节点 之前，善用 Set 节点 或 Function 节点 进行数据清洗。
- 整数转换：如果目标字段是
INT，在 Set 节点中使用Number($input.item.json.yourField)进行强制转换。 - 日期格式化：MySQL 标准日期格式为
YYYY-MM-DD HH:MM:SS。使用 Function 节点或 JS 代码处理：new Date().toISOString().slice(0, 19).replace('T', ' '); - JSON 字段处理：如果你的 MySQL 表中有 JSON 类型的字段，确保传入的是合法的 JSON 字符串，而不是对象。
记住：n8n 只负责搬运数据，数据清洗和类型校验最好在到达 MySQL 节点前完成。
FAQ 常见问题解答
1. n8n 连接 MySQL 需要安装额外的驱动吗？
不需要。n8n 官方镜像已经内置了 MySQL 的连接驱动（通常是 mysql2）。如果你是通过源码部署且遇到驱动缺失的错误，只需在项目根目录运行 npm install mysql2 即可。
2. 如何确保 n8n 与 MySQL 的连接安全？
首先，永远不要在公网直接暴露 MySQL 端口（3306）。如果 n8n 和 MySQL 部署在不同服务器，建议使用 VPN（如 WireGuard）或内网穿透工具（如 Frp）。其次，使用 n8n 的环境变量来管理数据库密码，而不是硬编码在流程中。
3. n8n 的 MySQL 节点支持执行原生 SQL 吗？
支持。在 MySQL 节点的操作类型中，选择 Execute Query (执行查询)。这样你就可以在 Query 字段中编写任意复杂的 SQL 语句，包括联表查询、聚合查询等，这比单纯的数据插入/更新要灵活得多。
总结与资源
连接 MySQL 是 n8n 自动化流程中最基础的环节，但也最容易因为环境差异而踩坑。总结来说，记住三个关键点：使用正确的网络地址（非 localhost）、配置合适的数据库用户权限、提前处理数据类型转换。
如果你在配置过程中遇到其他诡异的报错，欢迎在 N8N大学 的社区留言。作为你的引路人，我会持续分享更多实战干货。
推荐阅读：
