跳转至

故障排查

排障先确认失败发生在安装、配置、启动、服务状态、业务基础测试还是更新阶段。每次只处理一个阶段，并保留日志路径、截图和安装记录。

排障原则

排障不要先假设是代码缺陷。应先定位失败阶段，再收集证据，再判断属于部署环境、外部系统、配置问题、产品缺陷还是文档问题。

排查总流程

%%{init: {"theme":"base","themeVariables":{"fontFamily":"Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif","background":"#FAF9F5","primaryColor":"#F4F1EA","primaryTextColor":"#141413","primaryBorderColor":"#D8CBB8","lineColor":"#6F6B63","secondaryColor":"#FFFFFF","tertiaryColor":"#EAF1F7","clusterBkg":"#FAF9F5","clusterBorder":"#E8E6DC"},"flowchart":{"curve":"basis","padding":14,"nodeSpacing":34,"rankSpacing":44,"htmlLabels":true,"useMaxWidth":false}}}%%
flowchart LR
  A([发现问题]):::start --> B{先定位阶段}:::decision
  B --> C[安装 / 配置]:::step
  B --> D[服务 / 业务]:::system
  C --> E[查安装与配置日志]:::action
  D --> F[查服务与模块日志]:::action
  E --> G[修正后复测]:::preview
  F --> G
  G --> H([仍失败则升级]):::done


  classDef start fill:#141413,color:#ffffff,stroke:#141413,stroke-width:1px;
  classDef step fill:#F4F1EA,color:#141413,stroke:#D8CBB8,stroke-width:1px;
  classDef system fill:#EAF1F7,color:#141413,stroke:#6A9BCC,stroke-width:1px;
  classDef decision fill:#EFE7DA,color:#141413,stroke:#C58B5A,stroke-width:1px;
  classDef action fill:#F7E4DC,color:#141413,stroke:#D97757,stroke-width:1px;
  classDef done fill:#EDF1E7,color:#141413,stroke:#788C5D,stroke-width:1px;
  classDef module fill:#FFFFFF,color:#141413,stroke:#E8E6DC,stroke-width:1px;

常见问题

WhatsApp 测试状态混乱

处理步骤：

  1. 发送 reset 清空当前会话状态。
  2. 用一条清晰英文测试消息重新开始。
  3. 不要在同一个会话里连续混测 询价邮件 和 下单邮件，除非明确发送“start a new quote”或“create a new 下单邮件 email draft”。
  4. 如果 reset 后仍串入旧订单或旧草稿，保存完整 WhatsApp 对话截图并上报。

Outlook 草稿没有出现

处理步骤：

  1. 等待 1-2 分钟。
  2. 检查连接邮箱的 Drafts（草稿箱），不要只看当前打开窗口。
  3. 确认 本地连接服务（Windows Connector） 和 邮件草稿辅助服务 正在运行。
  4. 如 workstation 支持，运行 startAll 后重新发送 reset 并重测。
  5. 仍无草稿时，上报 任务编号、WhatsApp 输入、Agent 返回、发生时间和 Outlook 截图。

Agent 重复追问已提供信息

处理步骤：

  1. 用短行分隔方式补充一次信息，例如每行一个 信息名称: 内容。
  2. 如果同一信息继续被追问，不要反复试；保存原始输入、追问内容和补充内容。
  3. 上报时标明信息名称、产品类型、邮件类型、测试步骤。

Agent 选错邮件类型、产品或收件方

处理步骤：

  1. 不要点击 Confirm。
  2. 发送 correction，明确说明 quote request 或 place order、产品类型、目标收件方 和 收件方角色。
  3. 如果 correction 后仍错误，保存预览和 correction，并按产品/收件方判断问题上报。

ExtraMile lookup 无结果或结果不符

处理步骤：

  1. 确认 ExtraMile order ID 正确。
  2. 确认测试消息里列出了目标 issuers/custodians。
  3. 等待 查单任务 返回，不要立即重发多条相同请求。
  4. 如果任务长期 pending 或返回订单不符，上报 lookup 任务编号、order ID、发生时间和 Agent 返回内容。

安装器校验失败

处理步骤：

  1. 确认交付包没有被改名、拆分或重新压缩。
  2. 检查 manifest.json 中记录的 SHA-256 校验值。
  3. 重新复制完整交付包后再安装。

Excel 工作簿配置失败

处理步骤：

  1. 确认 AIML/EAM 文件是 .xlsx。
  2. 确认路径存在于授权 Windows 设备。
  3. 关闭正在占用文件的 Excel 窗口。
  4. 保存配置后重新运行 Excel 基础测试。

EasyView 或 ExtraMile 服务状态失败

处理步骤：

  1. 检查本地服务进程是否启动。
  2. 检查端口 8788 或 8787 是否被占用。
  3. 检查对应模块安装记录。
  4. 重启 Avenue stack 后再次访问 /health。

更新页显示未配置

处理步骤：

  1. 检查 %LOCALAPPDATA%\\AvenueConnector\\lifecycle-policy.json。
  2. 确认 feedBaseUrl 和 update token 配置已写入。
  3. 使用 Update-AvenueFromFeed.ps1 -PlanOnly 生成计划。

升级支持时需要提供

  • 安装器失败截图或 首次配置向导（Setup Wizard） 当前页截图。
  • %LOCALAPPDATA%\\AvenueConnector 下相关日志。
  • Get-AvenueInstalledArtifacts.ps1 输出。
  • 授权 Windows 设备名、Windows 用户、安装时间。
  • 出问题的 交付项 和业务操作步骤。

如果问题来自 WhatsApp/本地连接服务（Connector） 任务，还应提供 任务编号、原始输入消息、系统返回消息和对应时间段日志。