Roxy-WI在Rocky Linux 9安装后无法启动的解决方案

问题现象

用户在Rocky Linux 9系统上按照官方文档安装Roxy-WI后，访问Web界面时出现500内部服务器错误。查看Apache错误日志发现关键报错信息："ImportError: cannot import name 'Flask' from 'flask' (unknown location)"，表明Python无法导入Flask模块。

问题分析

该问题通常由以下两种原因导致：

1. Python依赖库未正确安装
2. Python环境存在权限问题

从日志细节和最终解决方案来看，本例属于第二种情况。虽然最初怀疑是依赖库缺失（如未安装Flask），但实际原因是Python的site-packages目录权限配置不当，导致WSGI应用无法正常访问已安装的Python包。

解决方案

方法一：检查并修复Python包权限

1. 定位Python的site-packages目录：

python3 -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())"

2. 确保Apache运行用户（通常是apache或www-data）对该目录有读取权限：

chmod -R o+rX /usr/lib/python3.9/site-packages

3. 如果使用虚拟环境，还需检查虚拟环境目录权限

方法二：完整重装Python依赖

1. 进入项目目录：

cd /var/www/haproxy-wi

2. 使用pip安装所有依赖：

pip3 install -r requirements.txt

3. 验证Flask是否可导入：

python3 -c "from flask import Flask; print(Flask.__version__)"

预防措施

1. 在安装Roxy-WI前，建议先创建专用Python虚拟环境
2. 使用systemd服务时，确保RuntimeDirectory设置正确
3. 生产环境中建议使用--user参数安装Python包，避免系统级权限冲突

技术原理

在Roxy-WI的WSGI架构中，mod_wsgi模块需要能够访问Python解释器和所有相关依赖。当出现"unknown location"错误时，通常表示：

• Python路径解析异常
• 动态链接库加载失败
• 文件系统权限限制

通过合理配置权限和环境变量，可以确保WSGI应用能正确加载所有必需的Python模块。