血泪教训：折腾n8n连接Redis时，我踩过的5个坑
大家好，我是N8N大学的主编。
最近在折腾一个高并发的数据同步项目，需要用到Redis做缓存和队列。作为n8n的重度用户，我当然首选用n8n的Redis节点来连接。本以为是个简单的配置，结果硬是折腾了一整晚。
如果你也在连接Redis时遇到莫名其妙的报错，或者节点死活不工作，那么这篇“血泪史”或许能帮你省去几个小时的调试时间。
坑一：连接方式选错，SSL/TLS 搞死人
这是新手最容易踩的坑。如果你用的是云服务商（比如阿里云、AWS）的Redis实例，它们通常强制要求使用SSL连接。
我在配置 Redis 节点时，习惯性地只填了 Host 和 Port，结果连接报错 ECONNRESET 或者 SELF_SIGNED_CERT_IN_CHAIN。
解决方案：
- 在n8n的
Redis节点配置中，找到 SSL/TLS 选项。 - 如果你是自建Redis且使用自签名证书，需要在 CA Certificate 处填入你的CA证书内容。
- 如果是云服务（如阿里云Redis），通常需要开启SSL，并在节点中选择 Allow self-signed certificates（允许自签名证书）或者直接填入云厂商提供的证书内容。
坑二：防火墙与网络隔离，连不上是常态
这个问题我遇到过两次。一次是我在本地Docker跑n8n，连接远程Redis；另一次是n8n和Redis都在Docker里，但不在同一个Network。
如果你的Redis节点一直转圈，或者报 ETIMEDOUT，先别急着改代码。
排查步骤：
- 检查Redis的
bind设置。如果是0.0.0.0，意味着允许所有IP连接（生产环境慎用，需配合密码）。 - 如果你的n8n在Docker中，确保Redis容器和n8n容器在同一个Docker Network下。使用
docker network ls和docker network inspect检查。 - 云服务器的安全组（Security Group）是否开放了Redis的端口（默认6379）？这是最容易被忽略的。
坑三：Redis 7.x 新特性导致的兼容性问题
这是一个比较隐蔽的坑。Redis 7.x 引入了一些新命令和数据结构，而n8n底层依赖的 node-redis 库如果版本过旧，可能无法正确解析。
我遇到的情况是，连接成功，但执行 HSET 或 JSON.SET 时，返回结果为空，或者报错提示参数格式不对。
笔者建议：
如果你的Redis版本是7.0以上，建议检查n8n的版本。如果是老版本n8n，尝试升级到最新版。如果无法升级，可以尝试在 Redis 节点的 Additional Fields 中，手动指定协议版本（如果节点支持），或者避免使用Redis 7.x 的新特性命令。
坑四：认证失败，密码正确却报错
“我密码明明是对的，为什么一直报错 NOAUTH Authentication required？” 这种情况通常发生在配置了ACL（访问控制列表）的Redis 6.x+实例中。
Redis 6.0 之后引入了多用户机制。如果你的n8n连接使用的是一个普通用户，而不是默认的 default 用户，且该用户没有对应的 SELECT 数据库权限，就会报错。
解决方案：
在Redis客户端执行 ACL LIST，检查你的用户是否有 +@all 或者至少 +select 的权限。如果权限不足，使用 ACL SETUSER 命令赋予相应权限。
坑五：数据格式乱码，中文变问号
这个问题虽然不报错，但数据存进去读出来全是 ???，非常搞心态。这是典型的字符编码问题。
n8n的节点默认处理JSON数据很好，但如果你手动写入的是字符串，且Redis服务端默认编码是UTF-8，而你的数据源是GB2312或其他编码，就会乱码。
避坑指南：
在写入Redis之前，使用 Set 节点或 Code 节点，确保你要写入的字符串已经被转换为UTF-8格式。n8n内部流转是UTF-8的，所以如果数据源是其他编码，必须在进入Redis节点前做一次转码。
FAQ：你可能还想问
1. n8n连接Redis需要安装额外的依赖吗？
使用官方的 Redis 节点是不需要的。n8n核心包已经集成了基础的Redis客户端库。但如果你需要使用Redis Stream或者特定的JSON操作，可能需要编写 Function 节点代码，或者确保你的Redis服务端开启了相应的模块（如ReJSON）。
2. 如何在n8n中使用Redis做队列（Queue）？
n8n本身支持配置Redis作为执行队列的后端（Queue Mode）。这需要在n8n的环境变量中配置 EXECUTIONS_MODE 为 queue，并设置Redis的连接信息。这与数据存储节点是两套逻辑。
3. 连接Redis时，报错“Ready check failed: NOAUTH”怎么办？
这通常意味着你填的密码不对，或者Redis实例根本没有设置密码，但你在n8n里填了密码。请检查Redis配置文件 redis.conf 中的 requirepass 项。如果为空，n8n的密码字段留空即可。
总结与资源
折腾n8n连接Redis，核心在于网络连通性和认证配置。只要这两步走对了，基本上不会再有大问题。
我是N8N大学的主编，希望这篇基于真实踩坑经验的文章能帮到你。如果你还有其他关于n8n的问题，欢迎直接在N8N大学（n8ndx.com）查阅更多教程。
