[Question]: Shared embedded chat URL fails to access documents after logout or when accessed by other users

快速结论：该报错通常发生在 RAGFlow 的“嵌入网页”共享聊天链接中，当用户未登录或通过无痕/其他浏览器访问时，文档检索（知识库内容）失败，而聊天界面本身可以正常打开。优先检查 RAGFlow 版本是否低于 v0.25.1，因为共享链接缺少知识库检索参数注入是已知根因，已在后续版本修复。

适用环境：RAGFlow（infiniflow/ragflow），涉及“Embed into webpage”功能；Issue 中未确认操作系统、Python、CUDA、显卡等具体版本。

最快修复方案：升级到 v0.25.1 或更高版本。该版本已包含两个修复 PR（#14121 与 #14190），分别解决共享链接缺失 knowledge 参数注入问题，以及共享页面不必要的 canvas SSE API 调用导致的授权错误。

注意事项：如果已运行 v0.25.1+ 仍复现，则可能是其他原因，需进一步抓取浏览器 Network 响应（F12 → Network 标签）和后端容器日志排查；Issue 中提供了 docker logs -f $(docker ps | grep "ragflow" | awk '{print $1}') 的排查命令。

问题场景

用户在使用 RAGFlow 的 “Embed into webpage” 功能生成公共聊天 URL 后，将该链接分享给外部用户或在未登录状态下访问。具体触发路径为：在 RAGFlow 中创建聊天并启用嵌入网页功能生成公共 URL → 登录状态下打开链接文档可正常加载 → 注销登录或使用无痕窗口/其他浏览器打开同一链接 → 提问涉及文档检索的问题时失败。

报错原文

[Question]: Shared embedded chat URL fails to access documents after logout or when accessed by other users

原因分析

可能原因：共享链接在访问文档检索 API 时仍依赖会话/用户级身份认证，而不是使用公共令牌或完整的共享权限范围。根据 Issue 评论中的维护者确认，该问题与 #14115 是同一类问题，根因是共享链接访问时，知识库检索参数未被正确注入到 prompt_config 中（当知识库 ID 存在但参数缺失时，未自动补全）。此外，共享聊天页面上不必要的 canvas SSE API 调用也可能触发授权错误，进一步干扰文档检索。这两个根因均已在 RAGFlow v0.25.1 中通过合并 PR 修复。

环境排查

确认 RAGFlow 版本号：是否为 v0.25.1 或更高版本；docker ps | grep ragflow 可查看容器版本信息。
确认部署方式：Docker、本地源码运行或云服务。
确认浏览器类型（Chrome/Edge 等）及是否使用无痕模式。
如已升级仍复现，检查浏览器 Network 响应内容及后端容器日志输出。

解决步骤

升级 RAGFlow 到 v0.25.1 或更高版本——这是维护者明确指出的修复版本，涵盖两个关键补丁：PR #14121（自动注入缺失的 knowledge 参数）和 PR #14190（跳过共享页面上不必要的 canvas SSE API 调用）。可优先尝试此方案。
验证升级后共享链接是否恢复——使用无痕窗口或退出登录后访问同一 URL，测试文档检索功能。
如果仍失败，抓取浏览器网络请求信息——按 F12 打开开发者工具，切到 Network 标签，复现操作后记录失败的请求及其响应体（含状态码和错误信息）。
收集后端容器日志——执行 docker logs -f $(docker ps | grep "ragflow" | awk '{print $1}')，将日志内容提供给维护者或用于进一步分析。

验证方法

在 RAGFlow 中创建聊天并启用“嵌入网页”功能，生成公共 URL 后，退出登录（或使用无痕窗口/其他浏览器）访问该 URL，向聊天发送一个需要知识库检索的问题。如果文档内容能正确检索并返回，说明问题已解决；如果仍出现 “file/resource not found” 或 “access denied” 类错误，说明还存在其他因素（例如浏览器缓存、网络代理或后端配置），需要按上述步骤继续抓包排查。