跳到主要内容

← 概述

OmniUDR 故障排除

所有 Nudr 读取返回 404 / 订阅者查找失败​

OmniUDR 从 HSS 后端满足每个读取请求。如果读取失败：

  1. 确认 hss_api_base_url 可以从 OmniUDR 主机访问，并且 HSS 正在运行。使用内置检查：在管理 API 上执行 GET /api/health/hss，并观察 omni_udr_hss_health 指标（1 = 正常，0 = 不正常）。
  2. 确认订阅者在 HSS 中存在并且是 启用 状态。禁用的订阅者（enabled: false）被视为未找到（对消费者返回 404）。
  3. 确认 {ueId} 使用 imsi-<digits> 格式（也接受裸 IMSI）。
  4. 观察 omni_udr_hss_requests_total{result="failure"} 和 omni_udr_hss_request_duration_ms，以区分 HSS 是否宕机/缓慢与真正缺失的订阅者。

当 HSS 无法访问时，消费者收到 5xx / 错误​

当 HSS 后端宕机或超时（每个请求 5 秒，健康检查 3 秒）时，HSS REST 客户端返回错误，OmniUDR 将其呈现给消费者（通常在读取资源上返回 404，或在订阅者代理上返回管理 API 502）。这是预期的 - OmniUDR 没有本地订阅者存储可以回退��恢复 HSS 可达性；一旦下一个检查成功，omni_udr_hss_health 返回 1。请注意，test_subscribers 是实验室辅助工具，并且在此版本中 不是 自动 HSS 宕机的回退。

SQN 更新的 PATCH 返回 200 而不是 204​

带有 PatchResult 主体的 200 表示 HSS 拒绝 了 SQN 更新；report 数组列出了失败的路径和 HSS 原因。成功的更新返回 204。检查 HSS 日志和 /api/hlr/update_sqn 路径。没有 sequenceNumber 的 PATCH 主体被视为成功的无操作（204）。

身份验证向量生成返回 404 / 500​

authentication-vectors POST 委托给 HSS /api/hlr/generate_auth_vectors 端点。404 表示订阅者在 HSS 中未知；500 表示 HSS 返回了错误或意外的响应格式。在重新同步时，确保 UDM 提供了 resynchronizationInfo，其中包含 rand 和 auts - OmniUDR 将它们连接成 HSS 期望的 rand‖auts 十六进制。此端点是专有的，仅 OmniUDM 应调用它。

策略数据看起来很薄​

AM 策略数据仅返回从订阅者的 UE-AMBR 级别派生的粗略 subscCats（premium ≥ 100 Mbps，standard ≥ 10 Mbps，否则为 basic），并且 praInfos 为空。该级别使用上行或下行 UE-AMBR 中的较高者。当订阅者的 HSS EPC 配置文件未携带 UE-AMBR 时，OmniUDR 提供 1000 Kbps 的默认值，因此未配置或映射错误的订阅者将落入 basic - 如果您期望的订阅者是 premium/standard 但显示为 basic，请验证 HSS 中的 EPC UE-AMBR（ue_ambr_ul_kbps / ue_ambr_dl_kbps）是否已配置。SM 策略数据是根据订阅者的 APN/QoS 和 PCRF 收费规则配置文件构建的。目前架构中没有专用的 5G 策略存储；这是设计使然。

AM 数据切片 (S-NSSAI) 不匹配​

4G HSS 记录不携带 5G 切片订阅，因此 AM 数据 NSSAI 由 OmniUDR 合成，并默认为标准实验室切片（eMBB，URLLC，mIoT）。如果 UE 请求的 SD 合格 S-NSSAI 被 AMF 拒绝（5GMM 原因 #62），请将 default_am_nssai（以及每个 DNN 的 dnn_snssai_map）与 AMF 提供的 NSSAI 对齐。请参阅 配置参考。

SM 数据为每个订阅者提供固定的 AMBR​

如果 SM 订阅数据对所有订阅者显示相同的会话 AMBR / QoS，而不考虑配置，则 HSS APN QoS 配置文件字段名称未被匹配，OmniUDR 正在回退到默认值。映射期望 OmniHSS 的 ApnQosProfile 字段（apn_ambr_dl_kbps，apn_ambr_ul_kbps，allocation_retention_priority，pre_emption_capability，pre_emption_vulnerability，qci）。请验证 HSS 订阅者记录是否携带这些字段。

上下文缓存在带外 HSS 更改���似乎过时​

AMF/SMF 注册缓存仅跟踪上下文写入，并用于 201 与 204 的决策；它不缓存读取数据。如果需要清除（例如，在测试循环后），请通过 DELETE /api/oam/subscriber-cache/{imsi}（或 .../all）刷新它。

最后于 更新