Uploaded avatars return 404 for other users in workflow collaboration

该报错通常出现在 Dify 自托管环境下的工作流多人协作场景:协作成员上传的头像在另一名协作者的界面中返回 404,只能显示姓名首字母。优先排查的并非浏览器缓存或网络问题,而是协作在线用户列表(presence)传入的是头像文件 ID,前端又通过**当前查看者**的会话去请求 /console/ap

快速结论:该报错通常出现在 Dify 自托管环境下的工作流多人协作场景:协作成员上传的头像在另一名协作者的界面中返回 404,只能显示姓名首字母。优先排查的并非浏览器缓存或网络问题,而是协作在线用户列表(presence)传入的是头像文件 ID,前端又通过**当前查看者**的会话去请求 /console/api/account/avatar 解析该 ID。

适用环境:Issue 中已确认的信息为 Dify 1.19、Self Hosted;触发前提是工作区已启用协作,且两个账号对同一工作流均有编辑权限。操作系统、Python、CUDA、显卡及具体依赖版本在 Issue 中未提供。

最快修复方案:暂无确认的一步修复方案。Issue 讨论给出的方向是:在已通过工作区/应用权限校验的协作 presence 返回数据中直接携带解析后的 avatar_url(复用 build_avatar_url()),前端 OnlineUsers 直接渲染该地址,而不是再用查看者会话去解析他人的上传头像。此方案在讨论中提出,但未注明已合入或已验证,可优先尝试。

注意事项:不建议为了让头像显示而放开账户头像接口的归属校验:#35771 引入该限制是为了防止任意上传文件 ID 被签名,保留这一限制更安全。上述修复属于代码层改动,讨论中未给出已发布版本或补丁编号,需要对后端序列化与前端渲染同时调整;改动后还应回归验证外部 HTTP(S) 头像、首字母回退,以及直接请求他人上传 ID 仍被拒绝。

问题场景

在 Dify 自托管部署中开启工作区协作后,两个有同一工作流编辑权限的账号同时打开工作流编辑器。账号 A 已上传自定义头像;当 A 出现在账号 B 的在线协作者列表后,B 的编辑器头部与展开的在线用户列表中,A 的头像无法显示,退化为姓名首字母。HTTP(S) 类型的外部头像仍能正常显示,只有“上传图片”类型的头像出问题。

报错原文

GET /console/api/account/avatar?avatar=<uploaded-avatar-file-id>
404 Avatar file not found

原因分析

工作流 presence 广播中携带的是已存储的头像值,即上传图片对应的文件 ID。头部组件拿到该 ID 后,调用 /console/api/account/avatar 进行解析,而该请求使用的是**当前查看者**的会话。

自 #35771 之后,账户头像接口只对“上传者本人”的上传文件进行签名,因此协作房间中的其他成员用同一接口解析该 ID 时会得到 404。这解释了为什么 A、B 均拥有编辑权限、且双方都能看到对方在线,但 B 依然拿不到 A 的上传头像。外部 HTTP(S) 头像由该接口直接返回 URL,不涉及签名,所以不受影响。

可能原因(基于 Issue 讨论):在线用户数据结构未提供解析后的头像 URL,导致前端只能回退到需要会话归属的账户头像接口。

环境排查

  • 确认 Dify 版本为 1.19(Issue 报告版本),并确认是否为 Self Hosted 部署。
  • 确认工作区已启用协作,且两个测试账号对同一工作流均具有编辑权限。
  • 确认出问题账号的头像类型为“上传图片”而非 HTTP(S) 外链;外链头像正常说明不是通用头像功能故障。
  • 在第二个账号的浏览器开发者工具 Network 面板中检查 /console/api/account/avatar 请求,确认状态码为 404 且查询参数中的 avatar 是文件 ID。
  • 确认两个账号均出现在同一在线协作者列表中,以排除“presence 未同步”这一独立因素。

解决步骤

  1. 先在第二账号浏览器中复现并记录失败的 GET /console/api/account/avatar?avatar=... 请求,确认返回 404 且参数为文件 ID,排除缓存与加载失败。
  2. 对照 Issue 讨论确认后端已有可复用的序列化路径:成员响应中的 avatar_url 由 build_avatar_url() 生成,保留 HTTP(S) URL,并对上传头像 ID 做签名。
  3. 可优先尝试:在 broadcast_online_users() 发出的协作 presence 数据中增加已解析的 avatar_url 字段;加入房间时已校验工作区与应用访问权限,可在此基础上下发。
  4. 可优先尝试:修改前端 OnlineUsers 组件,使其直接渲染 presence 中的 avatar_url,不再用查看者会话请求 /account/avatar 解析他人上传头像。
  5. 保持账户头像接口的归属限制不变,不要通过放宽 #35771 的签名范围来“修复”该问题。
  6. 如不需要立即改代码,可临时将相关账号头像改为 HTTP(S) 外链,作为规避手段(Issue 已验证外链头像可正常渲染)。

验证方法

用两个有编辑权限的账号同时打开同一工作流编辑器:账号 B 的头部与展开的在线协作者列表中应显示账号 A 上传的头像,且不再出现 404 请求。同时确认 HTTP(S) 外链头像、无头像时的首字母回退仍正常,并验证直接以 B 的会话请求 A 的上传头像 ID 时仍被拒绝,确保归属校验未被削弱。

参考来源

langgenius/dify #46663

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36045

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注