ThinkPHP项目迁移到新服务器无法访问_目录权限与入口文件配置-ThinkPHP-PHP中文网

ThinkPHP部署失败主因有四：①Web根目录未指向public导致404或源码下载；②runtime/cache目录无PHP进程写权限引发白屏；③PHP版本/扩展（opcache、fileinfo、pdo）不满足要求致致命错误；④重写规则未生效或PATH_INFO丢失致使路由失效。

thinkphp项目迁移到新服务器无法访问_目录权限与入口文件配置

入口文件 `index.php` 路径没对上

ThinkPHP 默认要求 index.php 在 Web 根目录下，且框架核心（thinkphp/）必须能被正确引入。新服务器常因文档根目录设置错误，导致 index.php 实际位于子目录（比如 /var/www/html/project/public/），但 Apache/Nginx 却把 /var/www/html/ 当作根目录——这时访问域名会 404 或直接下载 index.php 源码。

实操建议：

确认 Web 服务器配置的 DocumentRoot（Apache）或 root（Nginx）指向的是项目中的 public/ 目录，不是项目根目录
检查 index.php 里 define('APP_PATH', __DIR__ . '/../application/'); 这类路径是否仍有效；如果项目结构变了（比如从「根目录+public」变成「根目录即public」），../application/ 就会失效
Nginx 下务必启用 try_files $uri $uri/ /index.php?$query_string;，否则 URL 路由全崩

`runtime/` 和 `cache/` 目录写权限不足

ThinkPHP 启动时会尝试在 runtime/ 下生成日志、缓存、模板编译等文件。新服务器上 PHP 进程用户（如 www-data 或 nginx）往往没有该目录的写权限，表现为白屏、500 错误，或日志里反复出现 mkdir(): Permission denied。

实操建议：

用 ls -ld runtime/ 看目录属主和权限，确保属组/属主是 PHP 进程运行用户（不是 root，也不是上传用的 FTP 用户）
执行 chown -R www-data:www-data runtime/（Debian/Ubuntu）或 chown -R nginx:nginx runtime/（CentOS/RHEL）
不要简单 chmod 777 runtime/ —— 安全策略可能拦截，且部分主机禁用 world-writable 目录
如果用宝塔或 cPanel，注意「防跨站设置」可能主动限制了 runtime/ 的写入，需临时关闭验证

PHP 版本或扩展缺失触发致命错误

ThinkPHP 5.1+ 要求 PHP >= 7.1，6.x 要求 >= 7.4；若新服务器装的是 PHP 8.2，某些老项目依赖的 mysql_* 函数或未声明返回类型的闭包会直接 fatal error。另外，opcache、fileinfo、pdo_mysql 缺一不可，缺了不会报明确错误，而是卡在 autoload 或数据库连接阶段。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

实操建议：

在命令行跑 php -v 和 php -m | grep -E "(opcache|fileinfo|pdo)"，核对版本与扩展
打开 app_debug = true 后，查看 runtime/log/ 下最新日志，比浏览器白屏更准
如果用了 Swoole 或 Hyperf 兼容层，确认 swoole.so 已加载且版本匹配，否则 think\swoole\Server 类找不到

.htaccess 或 Nginx 重写规则未生效

本地开发用 Apache + .htaccess 自动处理路由重写，但新服务器可能禁用了 AllowOverride All，或 Nginx 根本没配 location / 块里的重写逻辑。结果就是所有非 index.php 的 URL 都返回 404，连后台登录页都打不开。

实操建议：

Apache 下检查 <directory></directory> 段落是否有 AllowOverride All，没有就加；同时确认 mod_rewrite 已启用（a2enmod rewrite）
Nginx 下不能只靠 try_files，还要确保 location ~ \.php$ 块里包含 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，漏了这句会导致 $_SERVER['SCRIPT_NAME'] 错乱，路由解析失败
ThinkPHP 6 默认关闭 URL 大小写敏感，但如果 Nginx 配置了 rewrite ^(.*)$ /index.php?s=$1 last; 这种旧式写法，容易和内置路由冲突，优先用 try_files

最麻烦的其实是多层代理后的真实 IP 和 PATH_INFO 丢失——比如套了 Cloudflare 或 SLB，$_SERVER['PATH_INFO'] 变空，Request::path() 拿不到路由段。这时候得手动在入口文件补 $_SERVER['PATH_INFO'] = $_SERVER['ORIG_PATH_INFO'] ?? '';，不然整个路由系统瘫痪。