快速结论:该报错通常出现在 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 未同步”这一独立因素。
解决步骤
- 先在第二账号浏览器中复现并记录失败的
GET /console/api/account/avatar?avatar=...请求,确认返回 404 且参数为文件 ID,排除缓存与加载失败。 - 对照 Issue 讨论确认后端已有可复用的序列化路径:成员响应中的
avatar_url由build_avatar_url()生成,保留 HTTP(S) URL,并对上传头像 ID 做签名。 - 可优先尝试:在
broadcast_online_users()发出的协作 presence 数据中增加已解析的avatar_url字段;加入房间时已校验工作区与应用访问权限,可在此基础上下发。 - 可优先尝试:修改前端
OnlineUsers组件,使其直接渲染 presence 中的avatar_url,不再用查看者会话请求/account/avatar解析他人上传头像。 - 保持账户头像接口的归属限制不变,不要通过放宽 #35771 的签名范围来“修复”该问题。
- 如不需要立即改代码,可临时将相关账号头像改为 HTTP(S) 外链,作为规避手段(Issue 已验证外链头像可正常渲染)。
验证方法
用两个有编辑权限的账号同时打开同一工作流编辑器:账号 B 的头部与展开的在线协作者列表中应显示账号 A 上传的头像,且不再出现 404 请求。同时确认 HTTP(S) 外链头像、无头像时的首字母回退仍正常,并验证直接以 B 的会话请求 A 的上传头像 ID 时仍被拒绝,确保归属校验未被削弱。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


