根本原因是UEditor默认调用php/controller.php，而ThinkPHP5禁止直接执行非入口文件且路由未对齐；需将上传逻辑迁入TP5控制器并通过正确路由暴露，并使用框架Request/File类、规范JSON响应格式及路径处理。
ThinkPHP5 中 UEditor 图片上传接口为什么返回 404 或 “未找到上传处理文件”
根本原因是 UEditor 默认调用 php/controller.php，而 ThinkPHP5 不允许直接执行非入口文件，且路由未对齐。你看到的 404、“No controller file” 或空响应，基本都卡在这一步。
解决方案不是复制粘贴原版 PHP 文件，而是把上传逻辑迁移到 ThinkPHP5 的控制器中，并通过正确路由暴露出来：
- 在
application/index/controller/下新建UeditorController.php - 在
route.php中添加规则：Route::any('index/ueditor/upload', 'index/Ueditor/upload'); - 确保 UEditor 前端配置的
serverUrl指向该地址，例如：serverUrl: "{:url('index/ueditor/upload')}"
如何让 UEditor 的 upload 方法兼容 ThinkPHP5 的 Request 和 Upload 类
UEditor 提供的原始 PHP 示例依赖 $_FILES 和 $_POST，但在 TP5 中应使用框架封装的 Request 和 think\File，否则无法自动校验、移动临时文件，也绕过上传配置（如大小、后缀限制）。
关键点：
立即学习“PHP免费学习笔记（深入）”；
- 不要用
$_FILES['upfile']，改用$this->request->file('upfile') - 上传路径必须用
ROOT_PATH . 'public' . DS . 'uploads'，不能写死./uploads（TP5 的 public 是 Web 根目录） - 需手动解析 UEditor 的
action参数（如uploadimage、uploadscrawl），不同 action 对应不同字段名和处理逻辑 - 返回格式必须严格遵循 UEditor 要求：
['state' => 'SUCCESS', 'url' => '/uploads/xxx.jpg']，多一个键或错大小写都会导致前端不显示图片
为什么图片上传成功但前端显示 “网络异常” 或 “未知错误”
这不是后端没返回，而是 JSON 响应被污染：常见于控制器里写了 echo、var_dump，或开启了调试模式导致输出了 ThinkPHP 的调试信息（如 trace bar HTML 片段），破坏了 JSON 结构。
排查与修复方式：
- 用浏览器开发者工具看 Network → Response，确认是否是纯 JSON（开头为
{"state":） - 关闭调试模式：
APP_DEBUG = false，或在上传方法开头加ini_set('display_errors', 'Off'); - 确保控制器方法最后只执行
return json($result);，前面不要有任何输出 - 注意 BOM 头：保存
UeditorController.php时用 UTF-8 无 BOM 编码，否则 JSON 前会多出不可见字符
TP5.1+ 使用 think\facade\Filesystem 存到云存储时要注意什么
如果项目已接入阿里云 OSS 或腾讯 COS，别直接用本地 moveTo()，应走 Filesystem 接口统一管理。但 UEditor 不支持异步回调或签名 URL，所以必须确保：
- 上传后立刻生成可公开访问的 URL，不能依赖私有 bucket + 临时 token（UEditor 不会带鉴权头请求图片）
- OSS 配置中，对应 uploads 目录的
ACL设为public-read - 返回的
url字段必须是完整外链，如https://xxx.oss-cn-hangzhou.aliyuncs.com/uploads/abc.jpg，不能是相对路径或内网地址 - 避免在
upload方法里多次putFile()—— ThinkPHP 的Filesystem默认不支持流式上传大图，建议先moveTo()到临时目录，再putFile()后删临时文件
真正麻烦的从来不是调通一次上传，而是当用户贴图、截图、拖拽、批量上传同时发生时，action 类型、文件名编码、中文路径、并发写入冲突这些细节全会在生产环境突然冒出来。
