更新时间：2025-04-07 18:24:18收藏订阅更新我的文档设置返回文档ugw_spi_implementation_not_exist问题原因：未录入 spi 接口实现配置或者录入后没有上线。凯发app官方网站的解决方案：线上环境，需要服务商再录入 spi 实现配置，可查看 spi 三方服务接入指南；并发起接口审核和能力发布上线审核，审核通过后（接口状态为 已接入，能力发布状态为 已上线），业务系统便可以通过 unifygw 发起线上调用（包括预发）。ugw_spi_app_insufficient_permission问题原因：spi 和 appid 之间没有绑定权限。凯发app官方网站的解决方案：线上环境，商户应用的 appid 需要订阅包含 spi 接口的功能包，功能包订阅流程与 openapi 相同。如果是定向功能包，需要由功能包的提供方在支付宝后台进行定向挂载；如果是全面开放功能包，商户需添加 spi 功能包，可查看 spi 三方服务接入指南。ugw_illegal_sign问题原因：支付宝出口网关验签商户的响应报文失败。凯发app官方网站的解决方案：验签商户响应报文失败场景的自助排查解决思路可参考如下方法。●商户检查响应报文签名字符集与 spi 接口实现配置上的编码类型一致。●商户检查响应报文使用的签名算法与请求报文中的 sign_type 保持一致。●商户检查签名私钥与上传的应用公钥是否为匹配的一对，检验方法可查看 密钥匹配。●商户检查应用是否开启了证书模式的密钥配置，如果开启了证书模式，返回给支付宝的响应报文需要添加 app_cert_sn 字段，该字段的生成方式可查看 常见问题。●商户检查对响应报文的加签方式是否符合规范，可查看 spi 三方服务接入指南 中的 商户签名规则 和 服务端实现 demo 完成签名。ugw_illegal_sign_type问题原因：该错误码表示 appid 没有设置“网关地址”，因为设置网关地址的时候同时会设置“加签方式”（如 rsa/rsa2），开放平台请求商户的时候需要获取加签方式以及加签方式对应的密钥去做加签。如果没有加签方式则无法匹配对应的密钥去做加签。凯发app官方网站的解决方案：联系商户设置应用网关地址即可。ugw_target_system_error问题原因：表示请求已经到商户服务端，但是服务端异常报错，返回的 http 状态码非 200。凯发app官方网站的解决方案：联系商户检查服务端配置是否正确，确保 http 请求返回 200。ugw_unknown_host_error问题原因：商户服务端域名无法解析。凯发app官方网站的解决方案：联系商户确认配置的域名是否公网可访问。ugw_io_exception问题原因：支付宝出口网关请求商户服务端超时，存在连接超时 or 读超时两种场景，具体超时原因查阅 unifygw-spi-digest 日志。凯发app官方网站的解决方案：联系商户确认服务端配置是否正确，公网是否能访问，后端内部服务是否存在耗时较高的场景。ugw_packets_parse_error问题原因：商户返回的报文格式不满足规范。凯发app官方网站的解决方案：查看 spi 三方服务接入指南 中的响应报文示例。ugw_appinfo_not_exist问题原因：应用不存在 or 应用未上线。凯发app官方网站的解决方案：将调用的 appid 进行上线操作。ugw_response_code_illegal问题原因：商户响应报文中的 code、msg、sub_code、sub_msg 不满足规范。凯发app官方网站的解决方案：查看 spi 三方服务接入指南 中 response 定义返回响应报文中的错误码字段。
