宝塔装Redis需四步：安装服务、启用PHP扩展、配置wp-config.php、放行端口及SELinux设置；其中PHP扩展未启用和密码配置错误最易导致连接失败。
宝塔里装Redis，其实就两步：服务装好 + PHP能连上
很多人卡在“明明点了安装，WordPress却报错连不上”，根本原因不是Redis没装，而是PHP压根不认识Redis。宝塔装Redis只是启动了一个后台服务（redis-server），它和PHP之间还隔着一层扩展——就像装了Wi-Fi路由器，但手机没开Wi-Fi开关一样。
- 进宝塔「软件商店」搜
Redis，选稳定版一键安装（2026年推荐 7.2.x 或 7.0.x） - 装完立刻去「服务」列表确认状态是「运行中」，别只看安装完成就以为OK
- 接着找你网站实际用的PHP版本（比如PHP 8.1），点「设置」→「安装扩展」→勾选
redis（不是memcached，也不是igbinary） - 扩展装完必须重启PHP服务（点「服务」里的PHP-FPM重启按钮），否则
phpinfo()里看不到redis模块
wp-config.php里加配置，密码不填≠留空
WordPress靠Redis Object Cache插件连Redis，但它不读redis.conf，只认wp-config.php里定义的常量。最常翻车的是密码处理：宝塔默认给Redis设了密码，但很多人复制教程时把// define('WP_REDIS_PASSWORD', 'xxx');这行注释掉了，结果插件真当没密码去连，自然超时失败。
- 在
wp-config.php里define('WP_DEBUG', false);下方插入以下几行（注意顺序，别塞到/* That's all, stop editing! */后面）：
define('WP_REDIS_HOST', '127.0.0.1');
define('WP_REDIS_PORT', 6379);
define('WP_REDIS_TIMEOUT', 1);
define('WP_REDIS_READ_TIMEOUT', 1);define('WP_REDIS_PASSWORD', '你的密码');
WP_REDIS_PASSWORD定义，留空或写''都会导致连接拒绝启用缓存后显示“Connected”≠真在用
后台点「Enable Object Cache」看到Status变成Connected，只代表PHP能握手成功，不代表缓存已生效。真实缓存是否工作，得看两点：插件有没有真正写入数据、Redis里有没有key生成。
- 进WordPress后台「设置」→「Redis」页面，往下拉看「Cache Info」区块：
Cache Hits和Cache Misses数字开始增长，才说明缓存正在参与请求 - 进宝塔「Redis 管理工具」→「命令行」，执行
KEYS *（仅开发环境用），如果返回一堆wp:*开头的key（比如wp:options:alloptions），说明缓存已写入 - 常见假阳性：插件激活了、状态连上了、但
Cache Hits一直是0——大概率是主题或某个插件调用了wp_cache_flush()强制清空，或者启用了WP_REDIS_DISABLE常量
防火墙和SELinux是隐藏杀手
本地回环地址127.0.0.1连不上？别急着重装，先查系统级拦截。CentOS系服务器默认开启SELinux，Ubuntu系则可能被UFW或云厂商安全组挡住6379端口，而宝塔面板本身不会自动放行。
- 宝塔「安全」菜单里检查是否已添加
6379端口放行规则（协议选TCP） - CentOS 7/8用户执行
sudo setsebool -P httpd_can_network_connect 1，否则Apache/Nginx子进程无法发起Redis连接 - 用
telnet 127.0.0.1 6379测试端口通不通，不通就不是WordPress问题，是系统层阻断
Redis配置本身不复杂，但宝塔把服务、扩展、权限、网络四层叠在一起，漏掉任何一层都会表现为“连不上”。尤其要注意密码字段的有无逻辑和SELinux布尔值，这两处没文档明说，但线上故障率最高。
