切换前必须确认：根目录路径未硬编码、.htaccess已转nginx rewrite、apache模块功能有nginx对应实现；备份需涵盖ssl证书、apache配置、php.ini；须用bt 7命令行切换而非面板按钮；切换后必查root路径、fastcgi_pass、伪静态、ssl路径、pathinfo配置。
切换前必须确认的三件事
宝塔面板不支持 Apache 和 Nginx 在同一站点上共存，所谓“一键切换”本质是停用 Apache、卸载其服务、重装 Nginx 并迁移配置——不是平滑过渡，而是重建。你必须提前确认：网站根目录路径未被硬编码在 PHP 代码里（比如写死 /www/wwwroot/site 而非用 $_SERVER['DOCUMENT_ROOT']）；.htaccess 规则已全部转为 Nginx rewrite 格式；所有依赖 Apache 模块（如 mod_rewrite、mod_expires）的功能，在 Nginx 中有对应实现（例如用 expires 指令替代 mod_expires）。
备份不能只靠面板“网站备份”功能
宝塔的“网站备份”只打包 www/wwwroot/xxx 下的文件和数据库 SQL，漏掉关键项：SSL 证书文件（通常在 /www/server/panel/vhost/cert/）、Apache 配置片段（/www/server/panel/vhost/apache/）、以及自定义的 php.ini 或 user.ini。实操建议：
- 手动压缩整个
/www/server/panel/vhost/目录（含apache/和nginx/子目录） - 导出所有站点的 SSL 私钥和证书（
cert.pem+privkey.pem），别只信面板“下载证书”按钮 - 运行
bt 16查看当前 PHP 版本，记下php.ini路径（如/www/server/php/80/etc/php.ini），并备份该文件
用 bt 命令行工具执行切换，别点面板“切换环境”按钮
面板 Web 界面的“切换环境”按钮在新版宝塔中已被弱化，实际调用的是旧逻辑，容易卡在“正在停止 Apache”状态。正确做法是 SSH 登录后执行：
bt 7
然后选择 2（Nginx）→ 选版本（推荐 1.22 或 1.24）→ 确认。该命令会自动：
- 停用并禁用
httpd服务（systemctl disable httpd） - 卸载 Apache RPM 包（CentOS）或 APT 包（Ubuntu），但保留
/www/wwwroot和数据库不动 - 安装 Nginx，并将原 Apache 站点配置转换为
/www/server/panel/vhost/nginx/xxx.conf - 重启
nginx和php-fpm，但不会自动重启 MySQL（这点常被忽略）
切换后必查的五个 Nginx 配置细节
自动生成的 Nginx 配置只是骨架，以下五处不手动改，90% 的站点会 502 或 404：
-
root指令必须与 Apache 时代一致，检查是否误写成root /www/wwwroot/xxx;（缺末尾斜杠）→ 应为root /www/wwwroot/xxx;（结尾无斜杠，Nginx 不要求） -
location ~ \.php$块里，fastcgi_pass必须指向正确的 PHP-FPM socket，常见错误是仍写127.0.0.1:9000，而实际应为unix:/tmp/php-cgi-80.sock（对应 PHP 8.0） - 伪静态规则：把 Apache 的
RewriteRule ^(.*)$ index.php [L]改成 Nginx 的try_files $uri $uri/ /index.php?$query_string; - SSL 配置段里，
ssl_certificate和ssl_certificate_key路径要和你备份的证书位置完全一致，不能依赖面板自动填充 - 若用了 Pathinfo，需在
location ~ \.php内加fastcgi_split_path_info ^(.+\.php)(/.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info;
改完配置后，务必运行 nginx -t 验证语法，再 systemctl reload nginx，不要直接 restart。
