必须先确认php cli和web服务器均使用8.0+版本，否则composer会静默降级安装tp6；vendor/autoload.php缺失多因网络中断或权限不足，应进项目根目录执行composer install而非重装；runtime目录须由web用户与cli用户共同可写。
ThinkPHP8.0在Linux服务器上部署失败，90%的情况不是代码问题，而是环境没对齐——尤其是PHP CLI版本和Web服务器用的PHP版本不一致，或者vendor/autoload.php根本没生成出来。
确认PHP CLI版本是否真为8.0+
很多人在宝塔或phpEnv里点选了PHP 8.2，但终端执行php -v仍显示7.4，这是因为系统PATH没刷新，或者Web服务器（如Nginx+PHP-FPM）和命令行用的是两套PHP二进制文件。必须同时满足两个条件：
- 终端运行
php -v输出≥8.0.0（推荐8.1或8.2） - Web服务器调用的PHP-FPM进程也运行在同一版本：查
ps aux | grep php-fpm，再看对应进程启动路径，比如/usr/bin/php-fpm81 - 验证扩展是否启用：
php -m | grep -E "mbstring|openssl|pdo|mysqlnd|fileinfo"，缺一不可
composer create-project静默降级到TP6？
这是最隐蔽的坑：当php -v低于8.0时，Composer不会报错，而是自动回退安装ThinkPHP6.x，目录结构看似正常，但app/command/下指令类无法注册、think命令报Class 'think\App' not found。解决方法只有两个：
- 先彻底清空项目目录，再确保
php -v正确后重试 - 加
--no-interaction和-vvv参数观察下载过程：composer create-project topthink/think tp8 --no-interaction -vvv - 国内务必配置镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
public/index.php 500错误且提示autoload.php不存在
现象是目录里有public/、app/，但访问时直接500，日志里写Failed to open stream: No such file or directory in /path/to/public/index.php on line 16。这说明vendor/目录压根没生成完整——常见于网络中断、杀毒软件拦截或磁盘权限不足。
- 不要删整个项目重来，先进入项目根目录，直接运行
composer install - 如果报
Permission denied，检查当前用户对vendor/和runtime/是否有写权限（非root用户部署时尤其注意） - 确保
runtime/目录存在且可写：mkdir -p runtime/log runtime/cache runtime/session，再chown -R www:www runtime/（宝塔默认用户组）
nohup运行自定义指令时任务无声退出
比如执行nohup php think sync:ad &后，日志里只有一行启动时间，后续无任何输出，任务实际没跑。原因通常是CLI模式下未加载正确的环境配置：
- ThinkPHP8默认从
.env读取配置，但nohup后台进程可能找不到该文件路径——务必用绝对路径启动：nohup /usr/bin/php81 /www/wwwroot/tp8/think sync:ad > /www/wwwroot/tp8/runtime/log/sync_ad.log 2>&1 & - 检查指令类中是否用了
Db::等依赖，若数据库配置在config/database.php里被硬编码了host/port，而CLI下.env未生效，就会连接失败静默退出 - 临时调试时去掉
nohup，直接php think sync:ad看完整报错
最易被忽略的一点：ThinkPHP8的runtime/目录必须由Web服务器用户（如www）和CLI执行用户（如部署账号）共同可写，否则缓存生成失败、指令日志写不进、甚至路由缓存优化都卡住——别只 chmod 755 就完事，得确认用户组归属和SELinux上下文（CentOS系）。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
