诊断信息与日志

先确定故障范围

记录以下信息：

• 发生时间和时区；
• 访问页面或执行的动作；
• 页面显示的完整错误文字；
• request ID、operation ID 或任务 ID；
• 是否刚完成升级、配置修改、域名切换或恢复；
• 问题影响全部用户还是单个账号、浏览器或资源。

不要一开始就清缓存、重建索引、重启全部服务或重复提交任务，这些操作会改变现场。

复制诊断信息

管理员进入“系统中心 → 运行状态”，点击“复制诊断信息”。系统会先显示预览，内容采用字段白名单，包含：

• 产品、发行版本、UI build、平台和运行时间；
• MySQL、Redis、Elasticsearch 和索引数量；
• 配置存储、队列、磁盘和授权语义状态；
• 最近少量脱敏失败及 request/operation ID；
• 检查时间。

诊断功能不会自动上传、修复、激活、升级或重新执行任务。

查看日志

后台可查看实时日志、按业务过滤并下载受保护的运行日志。服务器终端也可以查看：

docker compose logs --tail=200 app

优先找故障时间附近的第一条错误和关联 ID，不要只截最后一行。

分享前脱敏

即使系统提供了脱敏摘要，发送前仍应人工检查并移除：

• 许可证、API Token、Cookie 和请求头；
• 密码、私钥、DSN、数据库连接串；
• 带签名或临时凭证的下载 URL；
• 客户文件内容、完整邮箱、手机号和不必要 IP；
• .env、完整配置和整份数据库导出。

推荐的故障描述

版本：v1.0.4
发生时间：2026-09-13 14:30（Asia/Shanghai）
操作：后台资源列表应用“网盘类型”筛选
结果：页面提示……
影响：所有管理员均可复现 / 仅当前浏览器
关联 ID：req-……
已执行：刷新页面，未重启、未重建索引
附件：脱敏诊断摘要、错误区域截图

这种描述比“不能用了”更容易定位，也不会要求支持人员先索取整套服务器配置。