LNMP升级要注意啥

LNMP升级注意事项

一 升级前准备

• 完整备份：优先备份网站根目录、数据库（如全量导出）、以及各组件的配置文件（如 Nginx、PHP、MySQL/MariaDB）。数据库可用 mysqldump/mariadb-dump 全备，配置文件建议保留一份时间戳副本，便于回滚。
• 兼容性核查：确认新版本 Nginx/MySQL/MariaDB/PHP 与现有应用（如 WordPress、Discuz 等）兼容；跨小版本或主版本升级时尤需谨慎。
• 测试环境验证：先在测试环境演练升级流程与业务回归，再在生产实施，降低风险。
• 变更记录：记录升级窗口、操作步骤与回滚预案，便于审计与故障定位。
• 维护窗口与通知：选择低峰时段操作，并提前通知业务方或用户。

二 升级顺序与方式

• 推荐顺序：先升级 PHP，再升级 MySQL/MariaDB，最后升级 Nginx，以减少业务中断时间。
• 包管理器升级（通用）：
  • Debian/Ubuntu：执行 apt update && apt upgrade -y，按需安装对应组件（如 nginx、mysql-server/mariadb-server、php-fpm 及扩展）。
  • CentOS/RHEL：执行 yum update -y，按需更新 nginx、mysql-server/mariadb-server、php、php-fpm。
• 版本切换与扩展：
  • Debian 系可使用 ppa:ondrej/php 管理多版本 PHP；
  • CentOS 系可启用 EPEL/Remi 仓库选择所需 PHP 版本。
• 一键脚本与手动编译：
  • 若使用 LNMP一键安装包，可用其内置 upgrade.sh 按提示升级指定组件；
  • 特定版本或依赖冲突时，可选择源码编译安装，并更新软链接与配置路径。

三 关键配置与兼容性检查

• PHP-FPM 通信路径：升级 PHP 后，检查 Nginx 中 fastcgi_pass 是否指向新版本 PHP-FPM 的 socket 或端口，例如：
  • Unix socket：fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
  • TCP 端口：fastcgi_pass 127.0.0.1:9000;
    同时确保 php.ini、www.conf 等核心配置项（如运行用户、进程数、超时）符合业务需求。
• 扩展与依赖：按需安装/升级 php-mysqlnd、php-opcache、php-gd、php-curl 等扩展，避免应用报类/函数缺失。
• 数据库升级：执行 mysql_secure_installation（MySQL）或 mariadb_secure_installation（MariaDB）进行安全基线收敛；大版本数据库升级遵循官方升级路径与校验流程。
• 配置语法与生效：变更后用 nginx -t 校验配置，分阶段重启服务（如先 PHP-FPM，再 Nginx），减少瞬时错误暴露。

四 回滚与故障处理

• 快速回滚：
  • 配置回滚：用备份的 Nginx/PHP/DB 配置覆盖新配置并重启服务；
  • 版本回滚：使用包管理器降级到旧版本，或一键脚本/编译安装的回退方案；
  • 云环境：优先使用快照/镜像回滚到升级前状态。
• 常见问题定位：
  • 502/504：多为 PHP-FPM 未启动或 fastcgi_pass 路径错误，检查 systemctl status php-fpm 与 Nginx error.log；
  • 白屏/报错：查看 PHP-FPM error.log、Nginx error.log 与应用日志，核对扩展缺失与语法错误；
  • 数据库连接失败：核对 DB 主机、端口、用户权限 与新版本驱动兼容性。
• 服务自启动：升级后确认 nginx、php-fpm、mysqld/mariadb 已设为开机自启，避免重启后服务未拉起。

五 升级后验证与运维

• 版本与服务状态：执行 nginx -v、mysql --version（或 mariadb -V）、php -v 确认版本；用 systemctl status 检查各服务是否 active (running)。
• 业务回归测试：回归核心链路（登录、下单、支付、上传等），核对页面、接口与日志无异常。
• 性能与错误监控：观察 CPU、内存、连接数、慢查询 等指标，关注 error.log/access.log 与 PHP-FPM 慢日志，必要时调整 OPcache、连接池、超时 等参数。