Redis端口配置错误是ThinkPHP连接失败主因，需同步修改cache.php端口、.env变量、Redis客户端连接参数，并验证服务端实际监听端口及集群节点端口列表。
如果您在ThinkPHP项目中配置Redis时无法建立连接，或出现Connection refused错误，则很可能是Redis端口配置不正确或与实际运行端口不一致。以下是针对Redis端口配置的多种具体操作方式：
一、修改cache.php中的redis store端口参数
该方法适用于ThinkPHP 6/8标准缓存驱动配置，直接在缓存配置文件中显式声明端口值，确保与Redis服务监听端口完全匹配。
1、打开config/cache.php文件，定位到'stores' => ['redis' => [...]]配置块。
2、确认'port'键存在且值为整数类型，例如：'port' => 6379。
立即学习“PHP免费学习笔记（深入）”；
3、若Redis服务运行在非默认端口（如6380），将数值修改为对应端口：'port' => 6380。
4、注意：不可填写字符串形式的端口号（如'port' => "6379"），否则会导致静默连接失败。
二、通过.env环境变量覆盖端口配置
该方法适用于需要多环境差异化部署的场景，利用环境变量动态注入端口值，避免硬编码。
1、在项目根目录的.env文件中添加一行：REDIS_PORT=6379。
2、确保config/cache.php中redis store的port字段使用env('redis.port', 6379)读取方式。
3、检查config/cache.php内是否包含如下结构：'port' => env('redis.port', 6379)。
4、若未使用该写法，需手动替换原配置中的数字端口为env('redis.port', 6379)，否则.env设置无效。
三、在自定义Redis连接类中硬编码端口
该方法适用于绕过框架缓存驱动、直接实例化Redis客户端的场景，对连接控制粒度更细。
1、创建独立连接类（如app/common/RedisClient.php）。
2、在构造函数或连接方法中调用$redis->connect()时传入端口参数。
3、示例代码片段：$redis->connect('127.0.0.1', <strong><font color="green">6379</font></strong>);。
4、若使用phpredis扩展，必须确保第二个参数为整型；若使用Predis，端口需作为URI的一部分，例如：tcp://127.0.0.1:<strong><font color="green">6379</font></strong>。
四、验证Redis实际监听端口并同步配置
该方法用于排除服务端端口配置与应用端不一致的根本性问题，确保两端端口严格一致。
1、在服务器终端执行命令：ss -tuln | grep :6379（Linux）或netstat -ano | findstr :6379（Windows）。
2、若无输出，说明Redis未监听默认端口，需检查redis.conf中port配置项及是否启用bind限制。
3、若监听端口为其他值（如6380），则所有ThinkPHP配置中的port字段必须同步改为6380。
4、修改redis.conf后需重启Redis服务：systemctl restart redis-server（Linux）或重新运行redis-server.exe（Windows）。
五、配置Redis集群节点端口列表
该方法适用于Redis Cluster模式，需为每个集群节点单独指定IP和端口组合，不能仅填单一端口。
1、安装Predis依赖：composer require predis/predis:^1.1。
2、在自定义Cluster驱动类中，构建节点数组，每个元素含完整地址+端口，例如：['tcp://127.0.0.1:<strong><font color="green">7000</font></strong>', 'tcp://127.0.0.1:<strong><font color="green">7001</font></strong>']。
3、禁止在cache.php的'host'字段填写多个端口（如'host' => '127.0.0.1:7000,127.0.0.1:7001'），此写法被TP识别为单节点轮询而非Cluster。
4、确保每个节点地址中的端口号与对应redis-server实例启动时指定的--port参数完全一致。
