Polars导致Gunicorn Worker因Signal 4终止的部署问题求助

Signal 4（SIGILL）对应非法指令错误，结合你的场景——本地Docker镜像运行正常、公司服务器上Gunicorn Worker频繁崩溃，替换Polars为Pandas后恢复，核心问题几乎可以确定是Polars预编译二进制包与服务器CPU指令集不兼容。

Polars默认会编译使用较新的CPU扩展指令（如AVX2、SSE4.2）来提升性能，如果公司服务器的CPU型号较旧、不支持这些指令，进程就会触发SIGILL崩溃。

具体解决办法 #

• 从源码编译兼容版Polars
  修改Dockerfile，在安装Polars时指定基于通用CPU指令集编译：

  1. 添加编译依赖：

     RUN apt-get update && apt-get install -y build-essential rustc cargo
     

  2. 编译安装Polars：

     ENV RUSTFLAGS="-C target-cpu=generic"
     RUN pip install polars --no-binary polars
     

  这样生成的Polars二进制会兼容几乎所有x86_64 CPU，不会触发非法指令。

• 验证服务器CPU指令集
  在公司服务器上执行以下命令，查看CPU支持的指令集：

  lscpu | grep Flags
  

  如果输出中没有avx2、sse4_2等字样，说明CPU确实不支持Polars默认依赖的指令，源码编译是最可靠的方案。

• 尝试指定Polars兼容版本
  部分旧版本Polars提供了兼容更多CPU的预编译包，可以尝试安装特定版本：

  pip install polars==0.18.10 --only-binary :all: --platform manylinux_2_17_x86_64
  

  注意版本号需要根据实际情况调整，优先选择维护期内的稳定版本。

• 调整Gunicorn运行参数
  虽然不是根本解决办法，但可以优化Worker稳定性：

  gunicorn --workers 2 --worker-class gthread --threads 4 --worker-tmp-dir /dev/shm app:server
  

  使用线程模式（gthread）并将临时目录指向内存文件系统，减少IO相关的潜在问题。

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