Debian从Stretch升级到Bullseye后uWSGI段错误排查与修复

问题背景 #

将Debian系统从Stretch版本升级到Bullseye版本（Python从3.5升级至3.9）后，出现uWSGI段错误，报错回溯信息如下：

uWSGI process 314459 got Segmentation Fault !!!
*** backtrace of 314459 ***
/usr/bin/uwsgi(uwsgi_backtrace+0x2f) [0x558ed0a9b96f]
/usr/bin/uwsgi(uwsgi_segfault+0x23) [0x558ed0a9bd73]
/lib/x86_64-linux-gnu/libc.so.6(+0x3bd60) [0x7fd7184d247e]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(PyErr_Occurred+0xe) [0x7fd7184d247e]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(+0x12d655) [0x7fd718586655]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(_PyType_Lookup+0x2d) [0x7fd71858678d]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(_PyObject_GenericGetAttrWithDict+0x4d) [0x7fd71856a73d]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(+0x1121c9) [0x7fd71856b1c9]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(PyObject_GetAttrString+0x3b) [0x7fd71856730b]
/usr/lib/x86_64-linux-gnu/libpython3.9.so.1.0(PyObject_HasAttrString+0x7) [0x7fd718567d87]
/usr/lib/uwsgi/plugins/python3_plugin.so(uwsgi_python_autoreloader_thread+0x179) [0x7fd718a04d19]
/lib/x86_64-linux-gnu/libpthread.so.0(+0x8ea7) [0x7fd71b2d3ea7]
/lib/x86_64-linux-gnu/libc.so.6(clone+0x3f) [0x7fd71aaa2def]
*** end of backtrace ***

已尝试禁用psycopg2的SSL模式，问题未解决。

排查方向与修复方案 #

1. 定位核心问题：自动重载线程冲突 #

从回溯信息看，段错误发生在uwsgi_python_autoreloader_thread线程中，说明uWSGI的Python自动重载机制与Python3.9的线程安全机制存在冲突。Python3.9对全局解释器锁（GIL）和线程状态的处理比3.5更严格，旧版本的uWSGI Python插件可能未适配这种变化。

2. 临时修复：禁用uWSGI自动重载 #

修改uWSGI配置文件，添加或设置：

disable-reload = true

重启uWSGI服务：

systemctl restart uwsgi

如果段错误消失，即可确认问题根源在自动重载线程。

3. 彻底修复：更新或重新编译uWSGI与Python插件 #

Debian Bullseye默认的uWSGI版本可能对Python3.9适配不足，可通过以下方式解决：

• 用pip安装适配Python3.9的uWSGI：

  pip3.9 install --upgrade uwsgi
  

  确保使用Python3.9对应的pip工具，避免版本混淆。
• 手动编译uWSGI Python3插件：
  若使用系统包管理的uWSGI，可重新编译适配Python3.9的插件：

  apt-get source uwsgi
  cd uwsgi-*
  python3.9 uwsgiconfig.py --build python3
  cp build/python3_plugin.so /usr/lib/uwsgi/plugins/
  chmod 644 /usr/lib/uwsgi/plugins/python3_plugin.so
  

  编译完成后重启uWSGI服务。

4. 排查第三方依赖兼容性 #

升级Python后，部分旧依赖可能未适配3.9版本，执行以下命令检查依赖状态：

pip3.9 check

对存在兼容性问题的包进行升级，例如：

pip3.9 install --upgrade psycopg2-binary flask django  # 根据项目实际依赖调整

5. 验证Python解释器一致性 #

确保uWSGI使用的是Python3.9解释器，在uWSGI配置中明确指定：

plugin = python3
pythonpath = /usr/bin/python3.9

6. 调试补充排查 #

若上述方法无效，开启uWSGI调试模式获取更多细节：

enable-threads = true
log-level = debug

查看日志中线程状态、模块加载等相关信息，进一步定位问题。

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