你好，我是 N8N大学 的首席主编。作为一个在自动化战场上摸爬滚打多年的老兵，我深知在配置工作流时，最让人抓狂的不是逻辑跑不通，而是那个红红的报错提示。

尤其是当我们要连接数据库这种核心环节时，一个配置错误就可能让整个自动化流程瘫痪。今天，我整理了在 n8n 中连接 PostgreSQL 时最常遇到的 4 个报错。这不是简单的复制粘贴，而是我踩坑后总结的“排雷指南”。

报错一：connect ECONNREFUSED 127.0.0.1:5432

问题复现

这是新手最容易遇到的“拦路虎”。当你在 Postgres 节点中填好数据库名、用户名和密码，点击测试连接时，控制台（或节点日志）直接抛出：

connect ECONNREFUSED 127.0.0.1:5432

原因分析

用大白话说，这就是“敲门敲错门了”。n8n 默认尝试连接本地的 5432 端口。如果你的 PostgreSQL 安装在另一台服务器，或者安装在 Docker 容器里，n8n 根本不知道去哪找它。

特别是当你使用 Docker 部署 n8n 时，localhost 指的是 n8n 容器内部，而不是你宿主机上的数据库。

解决方案

1. 检查 Host 填写

如果你的数据库在 Docker 中运行，不要写 localhost，通常需要写 Docker 网络中的服务名（例如 postgres 或 db）。

如果数据库在宿主机（服务器）上，且 n8n 也是本机运行，确保 PostgreSQL 服务已启动，并且监听在 0.0.0.0 而不是 127.0.0.1（仅限本地访问）。

2. 网络连通性测试

N8N大学 建议你在 n8n 的服务器终端运行以下命令（如果你是 Docker 部署，进入容器执行）：

telnet 你的数据库IP 5432

如果连接失败，说明网络不通或防火墙拦截，请检查安全组或防火墙设置（如 ufw 或 iptables）。

报错二：password authentication failed for user "xxx"

问题复现

网络连接通了，端口也对了，但 n8n 节点报红：

password authentication failed for user "n8n_user"

原因分析

这通常不是 n8n 的问题，而是 PostgreSQL 的认证机制导致的。PostgreSQL 的 pg_hba.conf 文件配置了客户端认证方式。如果你的配置文件里设置了 md5 或 scram-sha-256，而你输入的密码有误，或者用户权限配置不对，就会被拒之门外。

还有一种常见情况：你使用了环境变量，但变量值里包含特殊字符（如 @, #），导致连接字符串解析异常。

解决方案

1. 验证凭据与特殊字符

先在本地使用 pgAdmin 或 DBeaver 等可视化工具，用相同的账号密码尝试连接。如果本地能连通，n8n 连不上，那问题大概率出在连接字符串的编码上。

如果密码包含特殊字符，请确保在 n8n 的配置中正确转义，或者直接修改密码为纯字母数字组合进行测试。

2. 修改 pg_hba.conf (进阶)

如果你确定密码无误，可能是认证方法不匹配。找到 PostgreSQL 数据目录下的 pg_hba.conf。

将对应 IP 段的认证方法从 scram-sha-256 改为 md5（或者 trust 测试用，生产环境慎用），然后重启 PostgreSQL 服务：

sudo systemctl restart postgresql

报错三：self signed certificate in certificate chain

问题复现

当你连接云数据库（如 AWS RDS, 阿里云 RDS）或开启了 SSL 的本地数据库时，报错如下：

self signed certificate in certificate chain

原因分析

这是一个典型的 SSL 证书验证错误。云厂商通常使用自签名证书或 Let's Encrypt 证书。n8n 的 Postgres 节点默认尝试验证 SSL 证书，如果找不到受信任的根证书，或者证书链不完整，连接就会被拒绝。

笔者在连接 AWS RDS 时就经常遇到这个问题，尤其是在 Docker 环境下，容器内缺少必要的 CA 证书包。

解决方案

1. 禁用 SSL 验证 (快速测试)

在 n8n 的 Postgres 节点配置中，找到 SSL 选项，勾选 Reject Unauthorized（拒绝未经授权的连接）将其关闭，或者直接设置为 false。

注意： 这只是为了快速排查问题。在生产环境中，为了安全，不建议长期禁用 SSL。

2. 配置 CA 证书 (推荐)

如果你必须使用 SSL，需要在连接参数（Additional Parameters）中指定 CA 证书路径。如果你使用 Docker，需要将 CA 证书文件挂载到容器内，并在连接字符串中添加：

sslmode=require&sslrootcert=/path/to/ca.crt

对于云数据库，通常下载云厂商提供的 CA 证书文件即可。

报错四：column "xxx" does not exist

问题复现

查询语句明明在数据库里能跑，但在 n8n 的 SQL 节点里执行就报错：

column "created_at" does not exist

原因分析

这是一个非常隐蔽的坑。PostgreSQL 是大小写敏感的。如果你创建表时使用了双引号包裹的字段名（如 "CreatedAt"），那么在查询时必须严格使用双引号。

更常见的情况是：你在 n8n 的 SQL 节点中使用了参数化查询（使用 $1, $2 占位符），但参数传入的类型不匹配，或者字段名拼写错误（特别是大小写）。

解决方案

1. 检查大小写与引号

在 PostgreSQL 中，不带引号的字段会被自动转为小写。如果你的字段是大写开头，请确保在 SQL 语句中使用双引号包裹：

SELECT "CreatedAt" FROM my_table;

2. 调试 SQL 语句

N8N大学 建议先在节点的 SQL 输入框里写死具体的值进行测试，排除参数传递的问题。

如果使用了 Postgres Node 的参数化查询，确保在 Parameters 数组中，参数的顺序和 SQL 中的 $1, $2 严格对应。不要混淆字段名和参数值。

FAQ 问答

Q1: n8n 支持 PostgreSQL 的哪些版本？
A: n8n 基于 Node.js 的 pg 库，理论上支持 PostgreSQL 9.6 及以上所有版本。推荐使用 PostgreSQL 12+ 以获得更好的性能和 JSONB 支持。

Q2: 连接云数据库（如 RDS）有什么特殊配置吗？
A: 除了 SSL 证书问题，最重要的是确保云数据库的安全组（Security Group）允许 n8n 服务器的 IP 地址访问 5432 端口。这是最常见的网络排查点。

Q3: 在 n8n 中执行 SQL 查询有性能限制吗？
A: n8n 主要用于轻量级的数据读写和同步。如果查询返回的数据量巨大（几十万行），建议在 SQL 中先做好 WHERE 过滤，避免内存溢出。大数据处理建议在数据库端完成，n8n 只取结果。

总结与资源

连接 PostgreSQL 时的报错，90% 都集中在 网络连通性、认证方式 和 SSL 配置 这三个方面。遇到问题不要慌，按照“先网络、后认证、再配置”的顺序排查。

如果你在 n8n 中遇到其他棘手的数据库问题，欢迎访问 N8N大学 (n8ndx.com) 查看更多实战案例，或者在社区中留言，笔者会第一时间为你解答。