4、环境准备：操作系统要求（Linux CentOS 7+）、Python版本（3.8+）、依赖库安装（lightgbm、flask、gunicorn、redis）

在部署 LightGBM 风控网关之前，必须确保底层环境满足所有依赖要求。本章将详细说明操作系统版本、Python 解释器版本以及核心依赖库的安装步骤，并给出生产环境下的最佳实践建议。

4.1 操作系统要求

生产环境推荐使用 Linux CentOS 7+ 或兼容的 RHEL 7+ 发行版。以下为关键系统组件的最低版本要求：

4.2 Python 版本要求

风控网关的推理服务基于 Python 3.8+ 构建。Python 3.6 及以下版本已停止安全更新，且部分依赖库（如 lightgbm 4.x）不再支持。

• 最低版本： Python 3.8.0
• 推荐版本： Python 3.10.12 或 3.11.5
• 不推荐： Python 3.12（部分旧版 lightgbm 和 gunicorn 存在兼容性问题）

建议使用 pyenv 或 conda 管理 Python 版本，避免与系统 Python 冲突：

# 使用 pyenv 安装 Python 3.10.12
pyenv install 3.10.12
pyenv global 3.10.12

# 验证版本
python --version
# 输出: Python 3.10.12

4.3 依赖库安装

风控网关的核心依赖包括 lightgbm（模型推理）、flask（HTTP 服务）、gunicorn（WSGI 服务器）和 redis（特征缓存与限流）。

4.3.1 核心依赖清单

4.3.2 一键安装命令

推荐使用 pip 安装，并优先使用国内镜像源加速：

# 创建虚拟环境（推荐）
python -m venv venv_gateway
source venv_gateway/bin/activate

# 安装核心依赖
pip install lightgbm==4.1.0 flask==3.0.0 gunicorn==21.2.0 redis==5.0.0

# 验证安装
python -c "import lightgbm; import flask; import redis; print('All dependencies installed successfully.')"

4.4 环境架构总览

下图展示了风控网关的完整环境依赖层次，从操作系统到应用层：

4.5 环境验证清单

完成安装后，建议按以下步骤逐项验证环境正确性：

1. 系统验证： cat /etc/centos-release 确认版本为 7+；gcc --version 确认 GCC 版本。
2. Python 验证： python --version 确认 ≥ 3.8；pip --version 确认 pip 可用。
3. LightGBM 验证： 执行 python -c "import lightgbm; print(lightgbm.__version__)" 输出版本号。
4. Flask 验证： 执行 python -c "import flask; print(flask.__version__)" 输出版本号。
5. Gunicorn 验证： 执行 gunicorn --version 输出版本号。
6. Redis 验证： 执行 python -c "import redis; r = redis.Redis(host='localhost', port=6379); print(r.ping())" 返回 True。

4.6 常见问题与避坑