ThinkPHP项目迁移后报错主因是环境适配问题：Linux大小写敏感导致模板/类名不匹配；Web根目录须指向public而非项目根；伪静态规则需正确配置；.user.ini可能引发403；自动加载失败多因vendor缺失或autoload路径错误。
ThinkPHP项目迁移到服务器后报错，多数不是代码本身有误，而是环境适配没到位。核心问题集中在大小写敏感、路径配置、伪静态规则、权限控制、自动加载失效
检查模板与控制器命名大小写
Windows开发时文件名不区分大小写，Linux服务器严格区分。比如控制器方法 getUserInfo() 默认会找 getuserinfo.html（全小写）模板，但你可能建了 getUserInfo.html。结果就是“模板不存在”。
解决方式：
• 把所有模板文件名统一改为小写（如 index.html、userlist.html）
• 或在调用时显式指定：$this->fetch('index/userlist')（不带扩展名）
• 同样注意控制器类名、方法名在URL中实际访问路径是否全小写（如 /index.php/index/userinfo 而非 /userinfo）
确认 Web 根目录和伪静态规则
常见错误是把整个 ThinkPHP 项目上传到网站根目录（如 /var/www/html/），但正确做法是让 public 目录成为 Web 入口。
必须确保：
• Nginx/Apache 的 root 指向的是 public 目录，不是项目根目录
• Apache 开启 mod_rewrite，且站点配置中 AllowOverride All
• Nginx 配置中禁用 if 判断重写，改用：
location / { try_files $uri $uri/ /index.php?s=$uri&$args; }
• 若部署在子目录（如 /admin/），需在 rewrite 中手动截断前缀，并校准 root 路径
排查 .user.ini 和目录权限
ThinkPHP 5+ 在 public 目录下常自动生成 .user.ini，用于设置 open_basedir，上线后容易导致 403 或白屏。
操作建议：
• 删除 public/.user.ini 文件
• 执行 chmod -R 755 runtime/（不是 777，避免安全风险）
• 确保 runtime 目录可写，且 Web 服务用户（如 www-data、nginx）对其拥有读写权限
• 若用宝塔面板，进入网站设置 → 网站目录 → 运行目录选 /public；伪静态选 ThinkPHP 模板或粘贴标准规则
立即学习“PHP免费学习笔记（深入）”；
验证自动加载与 vendor 部署
报 Class 'think\App' not found，本质是自动加载失败。
关键检查点：
• 服务器 PHP 是否启用 opcache，且 opcache.enable_cli = 1（命令行模式也要开）
• vendor/autoload.php 必须存在，不要漏传；推荐用 composer install --no-dev 生成，而非直接复制本地 vendor
• index.php 中引入 autoload 的路径不能是绝对硬编码（如 /Users/xxx/vendor/autoload.php），应改为：
require __DIR__ . '/../vendor/autoload.php';
• 清空 runtime/cache/ 和 runtime/log/ 再上传，避免本地缓存干扰
