很多刚接触 n8n 的朋友，在尝试连接数据库时，经常会遇到各种莫名其妙的报错。明明账号密码都对，为什么 n8n 就是连不上？其实，问题往往出在配置细节上。今天，N8N大学 就来帮大家彻底梳理一下，连接数据库到底要配置几个关键地方，才能确保万无一失。
一、问题复现：你是否也遇到了这些报错？
在连接数据库时，最常遇到的报错通常包含以下关键词：
ECONNREFUSED：连接被拒绝，通常是网络或端口问题。ETIMEDOUT：连接超时，可能是防火墙限制或网络不通。Authentication failed：认证失败，用户名或密码错误。Driver not found：缺少对应的数据库驱动。
这些报错让人头疼，但只要我们理清配置逻辑，就能轻松解决。
二、原因分析：为什么 n8n 会报错？
用大白话来说，n8n 连接数据库就像你要去一个陌生的地方，需要满足三个条件：
- 找到路：也就是数据库的地址（Host）和端口（Port）。
- 有钥匙：也就是数据库的用户名（Username）和密码（Password）。
- 选对交通工具：也就是选择正确的数据库类型（如 MySQL、PostgreSQL、MongoDB 等）。
任何一个环节出错，都会导致连接失败。而 n8n 的配置，正是围绕这三个核心展开的。
三、解决方案：3 个关键配置点，一个都不能少
笔者总结了 n8n 连接数据库的 3 个核心配置点，只要确保这三点正确，就能解决 90% 以上的连接问题。
1. 配置点一：数据库连接信息（Host & Port）
这是最基础的一步。在 n8n 的 Database Credentials（数据库凭证）中，你需要填写：
- Host：数据库服务器的 IP 地址或域名。如果是本地数据库，通常是
localhost或127.0.0.1。 - Port：数据库的端口号。MySQL 默认是
3306，PostgreSQL 默认是5432，MongoDB 默认是27017。
避坑指南：如果你的数据库部署在 Docker 容器中，且 n8n 也在容器中运行，请确保使用容器网络名称（如 mysql_container）作为 Host，而不是 localhost。
2. 配置点二：数据库认证信息（User & Password）
这是数据库的“钥匙”。确保你填写的用户名和密码具有访问目标数据库的权限。很多新手会混淆数据库的用户名和系统用户名，或者使用了默认的空密码。
避坑指南：对于 MySQL 8.0+ 版本，默认的加密插件可能不被 n8n 支持。如果遇到认证错误，可以尝试在 MySQL 中执行以下命令更新加密方式：
ALTER USER 'your_username'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
3. 配置点三：数据库名称与驱动（Database & Driver）
这是很多人忽略的一步。在 n8n 中，你不仅要选择正确的数据库类型（驱动），还要指定具体要连接的数据库名（Database Name）。
- Database Name：例如，你的 MySQL 中有一个名为
my_app的数据库，这里必须填写my_app。 - Driver：n8n 支持多种数据库驱动，如 MySQL、PostgreSQL、MariaDB 等。选错驱动会导致连接失败。
避坑指南：如果你的数据库需要 SSL 连接，记得在凭证设置中开启 SSL 选项，并上传相应的证书文件。
四、预防措施：如何避免未来再次踩坑？
为了避免反复调试，笔者建议养成以下好习惯：
- 使用环境变量：将数据库的敏感信息（如密码）存储在 n8n 的环境变量中，而不是硬编码在凭证里。
- 测试连接：在保存凭证后，点击“Test Connection”按钮，确保配置正确后再使用。
- 查看日志：如果连接失败，查看 n8n 的后台日志，通常会有更详细的错误信息。
五、FAQ 问答
Q1: 为什么我的 n8n 连接本地数据库失败？
A: 如果 n8n 运行在 Docker 容器中，容器内的 localhost 指向的是容器本身，而不是宿主机。请使用宿主机的真实 IP 地址，或者将数据库也运行在 Docker 中，并使用容器网络。
Q2: n8n 支持哪些数据库？
A: n8n 支持绝大多数主流数据库，包括 MySQL、PostgreSQL、MongoDB、SQLite、MariaDB、Oracle、SQL Server 等。你可以在 n8n 的凭证设置中找到完整的列表。
Q3: 连接数据库时提示“Driver not found”怎么办？
A: 这通常是因为你使用的 n8n 版本缺少对应的数据库驱动。对于 Docker 部署的 n8n，你可以通过安装额外的 npm 包来解决。例如，对于 Oracle 数据库，可能需要执行 npm install oracledb。
六、总结与资源
连接 n8n 数据库，关键在于确保 Host、Port、User/Password 和 Database Name 这四个核心配置点的准确性。只要细心检查，大部分连接问题都能迎刃而解。
如果你在配置过程中遇到了其他问题，欢迎访问 N8N大学 (n8ndx.com) 查看更多实战教程，或者加入我们的社区讨论。记住，每一次报错都是成长的机会，保持耐心，你一定能搞定它！
