在Frappe中创建新站点时遇Redis Queue报错求助

问题重现 #

• 执行命令 bench new-site test1.loc
• 完成MySQL root密码输入、Frappe DocTypes更新、国家信息更新、Administrator密码设置流程后，多次收到提示：请确保Redis Queue运行于@ redis://localhost:11000，最终站点创建失败

解决步骤 #

• 检查Redis服务状态
  执行命令查看Redis是否正常运行：

  systemctl status redis-server
  

  若服务未启动，执行以下命令启动并设置开机自启：

  systemctl start redis-server
  systemctl enable redis-server
  

• 验证Redis 11000端口监听状态
  检查端口是否被Redis占用：

  ss -tulpn | grep 11000
  

  如果端口未被监听，找到Redis Queue的配置文件（通常在Frappe bench目录下的config/redis_queue.conf，或者系统Redis配置/etc/redis/redis.conf），确认port参数设置为11000，修改后重启Redis服务：

  systemctl restart redis-server
  

• 核对Frappe的Redis配置
  进入bench目录，打开config/common_site_config.json文件，确认redis_queue字段值为"redis://localhost:11000"。若配置错误，修改后保存，重启bench服务：

  bench restart
  

• 排查端口占用冲突
  若11000端口被其他进程占用，执行以下命令定位占用进程：

  lsof -i :11000
  

  可选择停止占用进程，或修改Redis端口（需同步更新common_site_config.json中的redis_queue配置）。

• 测试Redis连接有效性
  使用redis-cli测试本地连接：

  redis-cli -p 11000
  

  在交互模式下输入PING，若返回PONG则连接正常。若连接失败，检查本地防火墙规则，确保11000端口允许本地访问。

内容的提问来源于stack exchange，提问作者Abhishek Chougule