ThinkPHP8.0部署失败主因是public目录未设为Web根、.env调试未关闭、composer install漏--no-dev；Apache/Nginx必须指向public，APP_DEBUG=false，且runtime目录需正确权限与SELinux上下文。
ThinkPHP8.0项目部署失败，八成卡在 public 目录没设对、.env 没关调试、或 composer install 漏了 --no-dev。不是框架问题，是部署动作本身容易跳过关键检查点。
Apache/Nginx 必须把 Web 根目录指向 public
ThinkPHP8.0 不再允许从项目根目录直接访问，所有 HTTP 请求必须经由 public/index.php 入口。若 Web 服务器根目录仍设在项目顶层（如 /var/www/tp8），会直接暴露 app/、config/ 等敏感目录，且路由全部 404。
- Apache：在
<directory></directory>块中确认DocumentRoot指向的是/path/to/tp8/public，不是/path/to/tp8 - Nginx：在
server块中检查root指令是否为/path/to/tp8/public - 宝塔面板：站点设置 → 网站目录 → 运行目录 必须手动改为
/public，默认值无效 - 验证方式：访问
http://your-domain.com/index.php能显示欢迎页，但http://your-domain.com/app/应返回 403 或 404
APP_DEBUG=true 必须关，.env 文件不能被 Web 访问
线上环境保留 APP_DEBUG=true 等于把数据库密码、路径结构、异常堆栈全打在 HTTP 响应里。这不是“建议关闭”，是只要上线就必须改掉的硬性操作。
- 编辑
.env，将APP_DEBUG=true改为APP_DEBUG=false - 同时检查
LOG_LEVEL=debug是否也降为warning或error，避免日志撑爆磁盘 - Nginx 需加屏蔽规则：
location ~ \.env$ { deny all; } - Apache 需确保
.htaccess生效（AllowOverride All），其内已含禁止访问.env的规则 - 额外验证：直接浏览器访问
http://your-domain.com/.env，必须返回 403/404，绝不能看到文件内容
生产环境 composer install 必须带 --no-dev 和 --optimize-autoloader
开发时装的 phpunit、fakerphp/faker 等 dev 依赖，在生产环境不仅无用，还会因缺失扩展（如 ext-xdebug）导致安装中断；不优化自动加载则性能下降明显。
立即学习“PHP免费学习笔记（深入）”；
- 正确命令：
composer install --no-dev --optimize-autoloader - 不要用
composer update上线，它会改composer.lock，破坏部署一致性 - 若提示
Class not found或Command "think" is not defined，先检查vendor/bin/think是否有执行权限（Linux/macOS 执行chmod +x vendor/bin/think） - Windows 下若
php think报错，尝试改用php vendor/bin/think，因系统未将vendor/bin加入 PATH
runtime 目录权限和 SELinux 可能静默阻断写入
ThinkPHP8.0 的日志、缓存、模板编译全依赖 runtime/ 目录可写。很多部署失败没有报错，只是页面空白或缓存不生效，根源常是权限或 SELinux 策略拦截。
- 确保
runtime/及其子目录属主为 Web 服务器用户（如 Apache 是www，Nginx 是nginx或www-data）：chown -R www:www runtime/ - CentOS/RHEL 上若启用了 SELinux，需运行：
chcon -R -t httpd_sys_rw_content_t runtime/ - 临时验证：在
runtime/下手动创建测试文件：touch runtime/test.txt，若失败即说明权限或策略问题 - 别忽略
public/static—— 如果前端资源由框架生成（如压缩后的 JS/CSS），该目录也需可写
最易被忽略的其实是 runtime 目录的 SELinux 上下文，尤其在 CentOS7/8 上，它不会报错，只会让日志停写、缓存失效、路由注册失败——现象像代码问题，实则是策略拦路。
