uWSGI Legion子系统无法启动Celery Beat问题求助

你遇到的Legion子系统不生效、无日志无报错的问题，90%以上的概率是通过pip默认安装的uWSGI 2.0.20未编译Legion模块。
pip源分发的uWSGI默认编译配置会裁剪很多非核心功能，Legion作为集群选主相关的可选子系统默认是关闭状态，这种情况下你配置文件里所有legion-开头的参数都会被uWSGI直接忽略，既不会执行相关逻辑，也不会输出任何报错，和你现在看到的现象完全吻合。从你贴的启动日志也能佐证：整个启动流程里完全没有Legion子系统初始化、节点注册的相关输出，和正常启用Legion的启动日志特征不符。另外单节点部署不存在选主冲突，这个前提可以排除。

按以下顺序逐层排查定位：

• 验证Legion模块是否编入当前uWSGI二进制，执行命令：

  uwsgi --build-options | grep legion
  

  如果执行后没有任何输出，直接确认是编译缺失问题；如果输出包含legion = true相关内容，再继续往下排查。
• 检查多播网络连通性：如果编译没问题，在uWSGI运行的节点上抓9191端口的UDP包：

  tcpdump -i any udp port 9191
  

  正常启动Legion后应该能看到节点周期性发送的多播心跳包，如果抓不到包，说明是防火墙拦截UDP流量、网卡未开启多播、多播地址配置错误导致节点无法完成选主，自然不会拉起托管的daemon进程。
• 检查pid目录权限：确认/var/run/celery/目录对uWSGI的启动用户有读写权限，权限不足会导致Legion选主成功后也无法写入pid文件、拉起celery beat进程。

对应排查到的问题逐一修复：

1. 修复编译缺失Legion模块的问题
   先卸载原有pip安装的uWSGI，指定编译参数重新源码安装，强制开启Legion和依赖的SSL加密支持：

   pip uninstall -y uwsgi
   UWSGI_PROFILE_OVERRIDE=legion=true,ssl=true pip install uwsgi==2.0.20 --no-binary :all:
   

   安装完成后重新执行之前的build-options检查命令，能看到legion相关编译项即为成功。
2. 修复多播连通性问题
   • 放通本地防火墙9191端口的UDP入、出站规则
   • 给业务对应网卡开启多播功能，把命令里的eth0替换成你实际的网卡名：

     ip link set eth0 multicast on
     

   • 如果你的机房网络不支持多播，可以直接把legion-mcast配置换成legion-udp，直接填写所有集群节点的单播IP做节点发现，不依赖多播能力。
3. 修复权限问题
   提前创建pid目录并赋权给uWSGI运行用户，比如uWSGI以www-data用户运行则执行：

   mkdir -p /var/run/celery
   chown www-data:www-data /var/run/celery
   

所有修复完成后重启uWSGI服务，正常情况下日志会输出Legion初始化、选举状态、当选lord后拉起celery beat的相关记录，也能通过ps查到对应的celery beat进程。

内容的提问来源于stack exchange，提问作者Neale Petrillo