thinkphp本地能上传、服务器报错，核心原因在环境差异：php上传配置未生效或不匹配（如file_uploads=off、upload_max_filesize与post_max_size不匹配）、临时/目标目录不可写（权限、selinux、路径不存在）、linux大小写敏感导致文件名或类名不一致、部署遗漏（vendor未安装、runtime未清空或路径硬编码）。
ThinkPHP本地能上传、服务器报错，基本不是代码问题，而是环境差异导致的。核心原因集中在 PHP 配置、文件系统特性、权限控制和部署细节这四类。
PHP 上传配置未生效或不匹配
本地开发环境（如 XAMPP、phpstudy）通常默认开启上传且限制宽松，而生产服务器往往保留默认值（比如 upload_max_filesize = 2M），导致稍大文件直接失败。
-
file_uploads = Off：整个上传功能被禁用，
$_FILES为空，框架甚至收不到文件 - upload_max_filesize 和 post_max_size 不匹配：后者必须 ≥ 前者 + 其他表单字段体积，否则请求在进入 PHP 前就被截断，页面可能直接空白
- 改完 php.ini 后没重启服务（php-fpm 或 Apache/Nginx），或改错了配置文件路径（可用
phpinfo()确认实际加载的 ini 文件）
临时目录或目标目录不可写
PHP 接收文件后先存到临时目录（upload_tmp_dir），再由 ThinkPHP 移动到目标位置。任一环节权限/空间/路径出问题都会报错。
- 临时目录（如
/tmp）不存在，或 Web 进程用户（如www-data、nginx）无写权限 - 磁盘空间不足（
df -h查看/tmp所在分区） - SELinux 或 AppArmor 拦截写操作（Linux 服务器常见，可用
ausearch -m avc -ts recent查日志） - 目标上传目录（如
runtime/upload）未手动创建，或权限不足（ThinkPHP 不自动创建多级目录）
Linux 文件系统与大小写敏感性
Windows 下不区分 GoodsList.html 和 goodslist.html，但 Linux 默认严格区分。控制器调用 $this->fetch('goodsList')，而模板文件名是 goodslist.html，就会提示“模板不存在”。
- 检查控制器方法名、模板文件名、类名、命名空间是否全部保持大小写一致
- 尤其注意 PSR-4 自动加载规则：
app\controller\User.php对应namespace app\controller，字母大小写错一个就加载失败
部署遗漏或缓存未清理
本地调试时常用 APP_DEBUG = true，上线后设为 false，但若缓存没清空，旧的调试缓存仍可能干扰运行。
- 未执行
composer install --no-dev，漏传vendor/autoload.php，导致Class 'think\App' not found -
runtime/目录未上传或权限不对（需可写，但不要传入本地已生成的cache/、log/子目录） -
index.php中 vendor 路径硬编码为本地绝对路径（如/Users/xxx/vendor/autoload.php），应改为__DIR__ . '/../vendor/autoload.php' - 切换到生产模式后未清空
runtime/cache/，旧缓存残留引发异常
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
