ThinkPHP上线需严守三大要点：public必须为Web根目录，runtime目录须逐级赋权并验证写入，APP_DEBUG必须显式设为false并清缓存；任一遗漏将导致500错误、路由失效或敏感信息泄露。
ThinkPHP 部署本身不复杂，但「上线流程复杂度」取决于你是否跳过关键检查项——多数线上问题（500 错误、路由失效、静态资源 404）都源于部署时的环境错配或权限遗漏，而非框架本身。
确认 PHP 环境和扩展是否达标
ThinkPHP 6.x 要求 PHP >= 7.2（推荐 8.0+），且必须启用 curl、mbstring、openssl、pdo_mysql（或对应数据库扩展）。常见错误是服务器默认没开 mbstring，导致路由解析失败，报 Class "think\App" not found 或空白页。
- 用
php -m | grep -E "(curl|mbstring|openssl|pdo)"快速核对 - 若用宝塔/AMH，进 PHP 设置 → 安装扩展，别只点「安装」就走，要重启 PHP 服务
- ThinkPHP 6 的
composer install必须在目标服务器执行（或带--no-dev），不能直接复制本地vendor目录（Windows 和 Linux 的符号链接、文件权限表现不同）
public 目录必须为 Web 根目录
这是最常被忽略的硬性要求。ThinkPHP 不允许将整个项目放 Web 根下（如 Apache 的 /var/www/html/），否则 app、config、runtime 等敏感目录可被直接访问。
- Nginx 示例配置中，
root必须指向/path/to/your/project/public，不是项目根目录 - Apache 需启用
mod_rewrite，且确保.htaccess在public下生效（AllowOverride All） - 如果只能把项目放子目录（如
https://site.com/tp6/），需在config/app.php中设置'base_url' => '/tp6'，并调整 Nginx 的location块加前缀重写
runtime 目录权限和写入测试
runtime 是日志、缓存、模板编译的落盘目录，部署后首次访问常因权限不足直接报 500，错误日志却可能被卡在写不进去的状态里。
立即学习“PHP免费学习笔记（深入）”；
- 执行
chmod -R 755 runtime/（Linux）或确保 Web 进程用户（如www-data或nginx）有读写权限 - 手动创建一个测试文件验证：
php -r "file_put_contents('runtime/test.txt', 'ok'); echo file_get_contents('runtime/test.txt');" - 若用宝塔，别只依赖「一键部署」按钮——它可能漏掉
runtime子目录（如runtime/log、runtime/cache）的权限继承
关闭调试模式并清空缓存
上线前不关 APP_DEBUG = true，等于把路由映射、SQL 查询、环境变量全暴露给用户；不清缓存则可能加载旧路由或配置，导致行为不一致。
- 修改
env文件：把APP_DEBUG=true改成APP_DEBUG=false - 执行
php think clear（TP6）或php think cache:clear（TP8），不是删runtime目录就完事——有些缓存存在 OPcache 或 Redis 中 - 检查
config/app.php中的'app_status'是否为'production'，部分中间件逻辑依赖此值
真正卡住上线的，往往不是「会不会部署」，而是没意识到 public 是唯一合法入口、runtime 权限要逐级验证、以及 env 文件里的 APP_DEBUG 必须显式关掉——这三个点漏一个，就可能花半小时查日志，最后发现只是少改了一行配置。
