OCP 调用 Switchover 接口报错

问题现象

客户通过 Python 脚本调用 switchoverPreCheck 接口时，返回 HTTP 500 错误。该问题仅在生产环境出现，在其他测试环境中接口可正常返回 HTTP 200。

OCP 日志中记录了 Unexpected API 或 NullPointerException 异常信息。

OCP 版本：4.3.5-20260105150333

问题原因

客户在调用 switchoverPreCheck 接口时，未传入 standbyocpClusterid 参数。OCP 服务端在处理请求时，因该参数为空而抛出 NullPointerException，导致返回 HTTP 500 错误。

关键信息

接口调用异常

OCP 日志中记录了接口调用异常信息，关键错误为 NullPointerException。

环境对比

• 测试环境：接口调用成功，返回 HTTP 200。
• 生产环境：接口调用失败，返回 HTTP 500。

接口状态与错误分析

• 接口请求的 URL 路径 /api/v2/ob/clusters/{clusterId}/tenants/{tenantId}/switchoverPreCheck 与 OCP API 文档一致，格式正确。
• 接口返回状态为 HTTP 500，并伴随 NullPointerException 错误类型。
• 错误类型分析：
  • URL 错误或资源不存在通常返回 404 Not Found。
  • 参数缺失或格式错误通常返回 400 Bad Request。
  • 服务端代码异常则返回 500 Internal Server Error，并可能附带具体异常类型（如 NullPointerException）。
• 结论：URL 路径正确，问题根源在于 OCP 服务端处理请求时，因内部对象为空（未判空）而抛出空指针异常。

问题的风险及影响

switchoverPreCheck 是执行主备切换前的预检查接口。该接口返回 HTTP 500 错误，将导致无法通过 OCP 完成切换前的条件校验，进而阻塞后续的主备切换或容灾切换操作。

影响租户

进行主备切换的租户。

适用版本

OCP 4.x 版本。

解决方法

客户 OCP 集群未正确配置 OCP 主备库信息。修正相关配置后，问题得以解决。

具体配置方法，请参考 OceanBase 官方文档：OCP 配置管理。

如何区分 OCP 是否为多集群模式

可通过 OCP 管理界面进行确认。具体方法，请参考 OceanBase 官方文档：管理 OCP 集群。

如果在管理界面中未找到多集群相关的配置项，则说明当前 OCP 并非运行在多集群模式下。

规避方式

在调用 switchoverPreCheck 接口前，请务必确认并传入所有必需的参数，特别是 standbyocpClusterid 参数。建议参考 OCP API 文档，核对接口的请求参数要求。