ThinkPHP部署时必须正确设置工作目录，否则会导致runtime写入失败、配置加载异常、上传路径错乱及静态资源404；应在public/index.php开头用chdir(dirname(__DIR__))强制切换至项目根目录，并清除runtime重建缓存。
ThinkPHP项目运行时因工作目录设置错误导致runtime缓存写入失败、配置文件加载异常、上传路径解析错乱，最终页面报错或静态资源404，必须在部署前明确指定正确的工作目录。ThinkPHP默认以入口文件index.php所在目录为基准推导APP_PATH、RUNTIME_PATH等常量，但当Nginx/Apache根目录未指向public、或使用子目录部署、或通过命令行执行任务时，工作目录极易偏离预期，引发连锁故障。
确认当前工作目录是否正确
在public/index.php最顶部插入以下调试代码：
echo 'Current working dir: ' . getcwd() . '
'; echo 'ROOT_PATH: ' . ROOT_PATH; exit;
访问页面，观察输出。若getcwd()返回的是服务器根目录（如/var/www/html）而非项目根目录（如/var/www/html/myapp），说明工作目录已偏移——【这会导致所有基于ROOT_PATH的路径拼接全部错误】。
立即学习“PHP免费学习笔记（深入）”；
强制重设工作目录（推荐方法）
第一步：打开public/index.php，在定义常量前插入以下代码：
chdir(dirname(__DIR__));
第二步：确保该行位于define('THINK_VERSION', ...)之前，且在require vendor/autoload.php之后。
第三步：删除runtime/目录，重新访问页面触发缓存重建。此操作将工作目录强制切换至项目根目录（即包含app/、config/、public/的父级目录），使ROOT_PATH = __DIR__ . '/../'真正生效。
注意：Windows系统下chdir()对路径分隔符不敏感，但Linux下必须用正斜杠；若项目嵌套过深（如/public/index.php → /a/b/c/myapp/public/index.php），需改用chdir(__DIR__ . '/../../..');向上跳转对应层数。
通过Web服务器配置固化工作目录
方法一：Nginx中使用fastcgi_param传递真实项目根路径
在server块内location ~ \.php$规则中添加：
fastcgi_param PHP_VALUE "auto_prepend_file=/var/www/html/myapp/public/set_cwd.php";
创建set_cwd.php文件，内容仅一行：
chdir('/var/www/html/myapp');
方法二：Apache中利用SetEnv设定环境变量
在public/.htaccess中添加：
SetEnv APPLICATION_ENV production
SetEnv APP_ROOT "/var/www/html/myapp"
然后在index.php中读取：
putenv('PWD=' . $_SERVER['APP_ROOT']); chdir($_SERVER['APP_ROOT']);
【务必确保APP_ROOT路径末尾无斜杠，否则chdir会失败】
命令行任务中单独处理工作目录
在artisan或自定义PHP脚本开头加入：
if (is_cli()) { chdir(__DIR__ . '/..'); }
这一步不可省略——CLI模式下PHP默认工作目录是执行命令时的当前路径，与Web请求完全无关。若你在/var/www/html下执行php think optimize:route，而项目实际在/var/www/html/myapp，则路由缓存将生成到错误位置，导致线上环境失效。
验证方式：在命令行脚本中执行echo getcwd();，确认输出为项目根目录。
