yii 1.x 与 yii 2.x 集成 ueditor 方式完全不同，核心难点在于后端上传接口的路由匹配与配置透传；90% 的“上传失败”“配置未加载”问题源于 ueditoraction 路由 404 或返回空白，需在控制器 actions() 中显式映射路径，并确保 url 路由、文件权限、imageurlprefix 与 imagepathformat 配置三者严格对齐。
直接说结论：Yii 1.x 和 Yii 2.x 集成 UEditor 的方式完全不同，不能混用；核心难点不在前端加载，而在后端上传接口的路由匹配和配置透传——90% 的“图片上传失败”“后端配置项未加载”错误都卡在这儿。
Yii 2.x 中 UEditorAction 路由 404 或返回空白
这是最常遇到的问题。Ueditor 前端默认发请求到 /ueditor（或 /index.php?r=ueditor），但 Yii 2 默认不处理这个路径。
- 必须在对应控制器里显式声明
actions()方法，并把upload（或ueditor）动作映射到kucha\ueditor\UEditorAction类 - 路径名必须和前端
serverUrl配置一致；比如你在 widget 里写了'serverUrl' => '/admin/ueditor'，那actions()就得配成'admin/ueditor' => [...] - 若用模块（如
backend），actions()必须写在模块对应的控制器里，不能只写在SiteController里就指望全站生效 - 检查是否启用了 URL 美化（
'enablePrettyUrl' => true）；若启用，确保urlManager规则没拦截/ueditor这类路径
imageUrlPrefix 和 imagePathFormat 配置失效
这两个参数控制上传后图片的访问地址和保存路径，但容易被忽略的是：它们只在 UEditorAction 的 config 数组里生效，前端 JS 配置无效。
-
imageUrlPrefix是拼在返回 URL 前的域名或子路径，比如设为'https://cdn.example.com'，上传后返回的图片地址就是https://cdn.example.com/image/20260420/123456.jpg -
imagePathFormat是服务器上的相对路径（相对于 webroot），支持占位符：{yyyy}、{mm}、{dd}、{time}、{rand:6}；注意它不会自动创建目录，需确保 PHP 有写入权限 - 如果上传后图片路径变成
/upload/image/xxx.jpg却无法访问，先确认该路径是否真实存在于web/目录下，且 Web 服务器（Nginx/Apache）允许直接访问
Yii 1.1 中 UEDITOR_HOME_URL 路径错乱导致 JS 报错
Yii 1.x 没有统一的 asset 发布机制，Ueditor 的 JS/CSS 资源路径极易出错，常见报错是 UE is not defined 或找不到 ueditor.all.min.js。
-
UEDITOR_HOME_URL必须以/开头，且指向 web 可访问的绝对路径，例如'/ueditor/'（不是'protected/extensions/ueditor/'） - 不要把 ueditor 放进
protected/目录；必须放在web/根目录下（如web/ueditor/），否则浏览器根本加载不到 JS - 若项目部署在子目录（如
http://example.com/myapp/），UEDITOR_HOME_URL应设为'/myapp/ueditor/'，而非硬编码'/ueditor/' - 检查浏览器开发者工具 Network 面板，确认
ueditor.config.js和ueditor.all.min.js返回状态码是 200，且响应内容非 HTML（常见于 404 时返回了 Yii 的错误页）
上传成功但富文本中图片显示为本地路径或 404
这说明后端返回了路径，但前端渲染或服务端路径解析出了问题。
- Ueditor 默认把图片插入为相对路径（如
src="/upload/image/xxx.jpg"），若页面 URL 是/admin/post/create，浏览器会尝试从/admin/upload/...加载——务必使用带协议或根路径的imageUrlPrefix - Yii 2 中若用了
AssetBundle自动发布 ueditor 资源，要确认basePath和baseUrl指向正确位置，否则config.json读取失败会导致“后端配置项没有正常加载” - 上传接口返回的 JSON 必须严格符合 UEditor 要求格式，尤其是
state字段不能是中文（如"state":"SUCCESS"），也不能多包一层 data
真正卡住人的从来不是“怎么引入 JS”，而是上传路径怎么和 Yii 的路由、文件系统、Web 服务器三者对齐；每个环节少一个斜杠、多一层目录、缺一次权限赋值，都会让图片静默消失。
