ThinkPHP如何部署到服务器_ThinkPHP上线部署注意事项【指南】-ThinkPHP-PHP中文网

thinkphp上传后报错class 'think\app' not found，主因是opcache未启用或vendor/autoload.php缺失；需开启opcache（含enable_cli=1）、正确部署vendor和runtime目录、修复index.php路径硬编码。

thinkphp如何部署到服务器_thinkphp上线部署注意事项【指南】

ThinkPHP 项目上传后报错 `Class 'think\App' not found`

这是最常见的部署失败现象，本质是自动加载没生效，不是框架缺文件。核心原因就两个：服务器没开启 opcache 或 opcache.enable_cli=0 导致 Composer 自动加载器失效；或者上传时漏掉了 vendor/autoload.php 或 runtime/ 目录被写死为本地路径。

实操建议：

确认服务器 PHP 已启用 opcache（php -i | grep opcache），且 opcache.enable_cli=1（CLI 模式下也要开，否则 think 命令生成的路由/配置缓存无法加载）
上传前务必执行 composer install --no-dev，不要直接复制本地 vendor；若用 Git 部署，确保 vendor/ 不在 .gitignore 里被跳过
runtime/ 目录必须存在且可写（Linux 下常用 chmod -R 755 runtime），但不要上传本地已生成的 runtime/cache/ 或 runtime/log/，清空再传
检查 index.php 中引入的自动加载路径是否硬编码了本地绝对路径（比如写死了 /Users/xxx/vendor/autoload.php），应改为相对路径或 __DIR__ . '/../vendor/autoload.php'

Apache/Nginx 下 URL 重写不生效，访问 `/index.php/index/index` 正常但 `/index/index` 404

ThinkPHP 默认依赖伪静态把请求统一交给 public/index.php 入口处理，服务端没配好重写规则，就会暴露 index.php 或直接 404。

实操建议：

Apache 必须开启 mod_rewrite，并确认站点配置中 AllowOverride All 已启用（不能只写 AllowOverride None）
Nginx 需在 server 块内添加标准 ThinkPHP 重写规则：
```
location / {<br>    if (!-e $request_filename) {<br>        rewrite ^(.*)$ /index.php?s=$1 last;<br>    }<br>}
```
注意不是 try_files，ThinkPHP 5.1+ 的 PATH_INFO 解析依赖 s= 参数
如果用宝塔、cPanel 等面板，别直接套用“Laravel”或“WordPress”伪静态规则，选 ThinkPHP 专用模板，或手动粘贴上述 Nginx 规则
确认 public/ 是 Web 根目录，不是项目根目录——很多新手把整个 ThinkPHP 文件夹扔进 /var/www/html，结果 public 没暴露，.htaccess 完全不生效

线上环境 `APP_DEBUG = true` 关闭后白屏或 500，日志里没错误信息

关闭调试模式后，ThinkPHP 会禁用错误显示，同时默认把异常写入 runtime/log/。白屏往往是因为异常没被捕获 + 日志目录不可写，导致错误静默丢弃。

实操建议：

先临时把 APP_DEBUG = true 改回 true，看是否能爆出具体错误（比如数据库连接失败、扩展缺失），定位后再关
检查 runtime/log/ 目录权限和所属用户（尤其宝塔部署时，PHP 运行用户可能是 www，而上传文件属主是 root，需 chown -R www:www runtime/）
确认 config/app.php 中 'log' => ['level' => ['error', 'notice']] 没被注释或删掉；若自定义过 log.type 为 trace 或 socket，线上环境容易因配置缺失直接崩
有些主机屏蔽了 file_put_contents，可临时在 public/index.php 开头加 ini_set('display_errors', '1'); 强制输出，快速验证是不是纯白屏问题

MySQL 连接报错 `SQLSTATE[HY000] [2002] Connection refused`

这个错误不是 ThinkPHP 的问题，而是应用层连不上数据库服务本身。线上 MySQL 往往监听 127.0.0.1 或 Unix socket，而配置里写了 localhost，在部分 Linux 发行版（如 Debian/Ubuntu）下会强制走 socket 而非 TCP，一旦 socket 文件路径不对就拒绝连接。

实操建议：

把数据库配置中的 'hostname' => 'localhost' 改成 'hostname' => '127.0.0.1'，绕过 socket 解析逻辑
确认 MySQL 服务确实在运行（systemctl status mysql），且 bind-address 没设成 127.0.0.1 以外的地址（除非你真要外网访问）
检查数据库用户是否有从当前服务器 IP（或 %）登录的权限：SELECT host, user FROM mysql.user;，别只记得创建用户，忘了 GRANT 权限
云服务器（阿里云、腾讯云）还要看安全组是否放行了 3306 端口——即使本地连得上，防火墙也可能拦住 PHP 进程发起的连接