BlueHost共享主机部署Flask报500错误libssl.so.3加载失败

问题根因 #

SSH命令行执行脚本正常、Web访问报libssl.so.3缺失，本质是Apache的fcgid运行环境和你SSH登录的shell环境完全隔离。
你SSH下运行正常，是因为登录shell会自动加载家目录下.bashrc/.bash_profile中配置的LD_LIBRARY_PATH，但共享主机默认会拦截敏感环境变量传递，.htaccess里写的PassEnv LD_LIBRARY_PATH不会生效，fcgid启动Python解释器时既不会加载用户shell配置，也拿不到你传的库路径，自然会报共享库找不到的错误。

解决方案 #

方法1：fcgi脚本内注入环境变量（优先尝试，配置最简单） #

不要依赖Apache传递环境变量，直接在flask.fcgi最顶部、导入任何业务模块前手动写入环境变量，把你之前配置的OpenSSL库实际路径填进去即可：

#!/path/to/venv/bin/python
import os
# 替换下方路径为libssl.so.3所在的父目录，例如自定义安装的openssl的lib目录
os.environ["LD_LIBRARY_PATH"] = "/home/your_account/openssl/lib64:/usr/local/lib:" + os.environ.get("LD_LIBRARY_PATH", "")

from wsgiref.handlers import CGIHandler
from server import app

CGIHandler().run(app)

修改后直接刷新页面测试即可，共享主机环境不需要手动重启Apache。

注意：路径不要直接写到libssl.so.3文件本身，只需要写到该文件所在的父目录层级。

方法2：Shell包装脚本启动（适配Python启动即加载库的场景） #

如果方法1不生效，说明Python解释器在执行os.environ赋值前就已经开始加载动态库，此时可以用shell脚本提前注入环境变量再启动Python：

1. 将现有flask.fcgi重命名为flask_app.py
2. 新建同名flask.fcgi文件，写入以下内容，替换所有路径为你的实际路径：

#!/bin/bash
export LD_LIBRARY_PATH="/home/your_account/openssl/lib64:$LD_LIBRARY_PATH"
/path/to/venv/bin/python /path/to/public_html/flask_app.py

3. 给新的flask.fcgi添加可执行权限：chmod +x flask.fcgi
   该方式会在Python解释器启动前就把库路径注入进程环境，完全绕开Apache的环境变量限制。

额外排查提示 #

• 先在SSH下执行echo $LD_LIBRARY_PATH和find ~ -name "libssl.so.3"，确认库存放路径和你配置的路径完全一致，避免路径写错
• wsgiref.handlers.CGIHandler仅适合调试使用，性能很差，问题解决后建议替换为兼容Python3的flup版本fcgi处理逻辑提升稳定性
• 该问题大概率是你自行编译Python虚拟环境时指定了自定义OpenSSL安装路径，系统默认Python不会出现该类依赖缺失问题

内容的提问来源于stack exchange，提问作者delta-alph