linux thinkphp为何报错

在 Linux 下运行 ThinkPHP 报错 的原因很多，常见情况如下，你可以对照排查：

一、最常见原因（90% 都是这些）

1️⃣ 目录权限问题（Linux 特有）

ThinkPHP 需要写日志、缓存、运行时文件。

报错示例：

• failed to open stream: Permission denied
• runtime/xxx 不可写

解决方法：

chmod -R 755 runtime
chmod -R 755 storage
chown -R www:www runtime

（nginx/apache 用户通常是 www 或 www-data）

2️⃣ 没有开启伪静态 / rewrite

报错：

• 除了首页都能访问
• 404 Not Found

解决（Nginx 示例）：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=/$1 last;
    }
}

Apache 需开启 mod_rewrite，并确认有 .htaccess

3️⃣ PHP 版本不兼容

报错：

• syntax error
• unexpected ]
• Your requirements could not be resolved

检查：

php -v

• ThinkPHP 5.1 → PHP ≥ 5.6
• ThinkPHP 6.0 → PHP ≥ 7.1
• ThinkPHP 8.0 → PHP ≥ 8.0

4️⃣ 缺少 PHP 扩展

常见缺失扩展：

• mbstring
• pdo_mysql
• openssl
• fileinfo
• gd

安装示例（CentOS）：

yum install php-mbstring php-pdo php-gd

5️⃣ Composer 依赖未安装

报错：

• Class not found
• vendor/autoload.php not found

解决：

composer install

二、ThinkPHP 自身常见报错

6️⃣ 配置文件错误

• database.php 写错
• .env 不存在或格式错误

检查：

cp .env.example .env

7️⃣ 日志查看（最重要）

看真实错误：

runtime/log/

或开启调试：

// .env
APP_DEBUG = true

三、快速自查清单 ✅

• [ ] 权限 ok？
• [ ] rewrite ok？
• [ ] PHP 版本对？
• [ ] vendor 存在？
• [ ] 扩展齐全？
• [ ] 日志看了？

四、你可以这样发给我（更快定位）

把 完整报错信息 或 截图文字 发出来，例如：

ThinkPHP 6 + Nginx，访问报错：xxx

我可以直接告诉你 是哪一行、怎么改 ✅