修改宝塔面板网站根目录前必须确认三件事：当前站点是否启用SSL、是否绑定了多个域名、新目录是否已存在且权限正确（www用户可读写）；SSL证书路径和伪静态规则需同步更新；include或location块中的旧路径也要手动修改。
修改宝塔面板网站根目录前必须确认的三件事
改错路径会导致网站 502 或直接打不开，不是点几下就能完事。操作前先确认：当前站点是否启用 SSL、是否绑定了多个域名、新目录是否已存在且权限正确（www 用户可读写）。SSL 证书路径和伪静态规则都硬编码了旧路径，不更新会出问题。
- 新目录必须由
www用户拥有，执行chown -R www:www /www/wwwroot/new-site - 如果用了
include或location块引用旧路径（比如防跨站配置），要同步改掉 - 宝塔不会自动迁移数据库配置或程序内的绝对路径（如 WordPress 的
WP_CONTENT_DIR），这些得手动查
在宝塔后台直接修改站点根目录的操作步骤
这是最常用场景：只是换一个本地目录，不改域名、不换程序。进「网站」→ 点击目标站点右侧「设置」→「网站目录」→ 修改「网站根目录」输入框里的路径 → 保存。但注意：保存后不会自动重启 Nginx/Apache，必须手动点「重载配置」或「重启」对应服务。
- 路径必须以
/www/wwwroot/开头，不能填相对路径或~/ - 如果新目录为空，访问会报
403 Forbidden；如果含index.php但没开 PHP，会下载文件而不是执行 - 修改后立即生效的是 Nginx/Apache 配置，但 OPcache、Redis 缓存、PHP-FPM 进程里可能还缓着旧路径，建议顺手清下
opcache_reset()
遇到 502 Bad Gateway 时重点检查的三个配置项
改完根目录最常见的错误就是 502，基本不是路径写错，而是 PHP 处理器找不到入口或权限断了。别急着重启，先看这三项：
-
php-fpm进程用户是否能访问新目录：执行ps aux | grep php-fpm看运行用户，再用sudo -u www ls -l /www/wwwroot/new-site测试 - Nginx 的
root指令是否同步更新：进「网站」→「设置」→「配置文件」，搜索root，确认它和后台填的路径完全一致（注意末尾斜杠） - 宝塔的「PHP 版本」设置是否仍指向旧站点的配置——点「设置」→「PHP 版本」，选中当前站点，再点一次确认，强制刷新 PHP 处理器绑定
用命令行快速验证新根目录是否生效
后台改完别只刷浏览器，用命令行绕过缓存和 DNS 直接测真实响应。进服务器终端，用 curl 模拟请求最稳妥：
curl -I http://localhost -H "Host: your-domain.com"
看返回的 Server 和 X-Powered-By 是次要的，关键是 HTTP/1.1 200 OK 和 Content-Length 是否非零。如果返回 404，说明 Nginx 找不到文件；返回 403，基本是权限或 autoindex 关闭导致；返回空内容，大概率是 PHP 没跑起来，去查 /www/wwwlogs/your-domain.error.log。
路径软链接、SELinux、宝塔的「防跨站攻击」开关，这三个地方最容易被忽略。尤其是开了防跨站，新目录不在白名单里，连 file_exists() 都会失败。
