java调用第三方支付接口失败时，应捕获具体异常类型（如alipayapiexception、ioexception）、记录脱敏日志（含订单号、错误码等）、按性质决定重试（网络超时可重试，参数错误不重试），并使用结构化日志与统一错误码便于监控。
在调用第三方支付接口失败时，Java 异常处理的核心是：捕获具体异常、区分可重试与不可重试场景、记录足够诊断信息的日志，并避免敏感数据泄露。
捕获明确的异常类型，而非只用 Exception
第三方 SDK 通常会抛出自有异常（如 AlipayApiException、WechatPayException）或标准 HTTP 异常（如 IOException、HttpClientErrorException）。应优先捕获这些具体类型，便于分类处理：
- 网络超时、连接拒绝 → 捕获
IOException或 SDK 封装的网络异常 - 签名错误、参数缺失 → 捕获 SDK 的业务异常（如
AlipayApiException），其 message 通常含错误码 - HTTP 4xx/5xx 响应 → 捕获
RestClientResponseException（Spring RestTemplate）或对应 HTTP 客户端异常
日志内容要包含关键上下文，但脱敏敏感字段
记录日志时需包含：时间、商户订单号、支付渠道、请求 ID（如有）、错误码、简明原因、原始响应体片段（不含银行卡号、身份证、密钥等）。例如：
2024-06-15 14:22:37.892 ERROR [payment-service]
Failed to call WeChat Pay JSAPI order creation.
orderNo=ORD2024061500123, channel=wxpay, requestId=tx1a2b3c4d,
errCode=INVALID_REQUEST, errMsg=invalid parameter: openid,
responseBody={"errcode":40003,"errmsg":"invalid openid"}
注意：不要记录完整请求参数（尤其含 token、sign、用户手机号明文），可用 log.info("req: openid={}, appid={}", maskOpenId(openId), appId) 方式脱敏。
按异常性质决定是否重试，并在日志中标记重试动作
不是所有失败都该重试。建议：
- 网络超时、502/503 等临时性错误 → 可重试（最多 2 次），日志中注明
retry=1/2 - 400 参数错误、401 鉴权失败、404 接口不存在 → 立即失败，记录
retry=no (invalid request) - 支付平台返回明确业务拒绝（如余额不足、风控拦截）→ 不重试，记录
business_rejected: insufficient_balance
使用结构化日志 + 错误码归类，方便排查和监控
在日志中加入统一错误码（如 PAY_WECHAT_REQ_FAILED）和业务标签（pay_type=jsapi），便于 ELK 或 Sentry 聚类分析。示例（Logback + JSON encoder）：
{
"timestamp": "2024-06-15T14:22:37.892Z",
"level": "ERROR",
"service": "payment-service",
"errorCode": "PAY_WECHAT_REQ_FAILED",
"payType": "jsapi",
"orderNo": "ORD2024061500123",
"channel": "wxpay",
"httpStatus": 400,
"weChatErrCode": "INVALID_REQUEST",
"message": "WeChat Pay API returned invalid parameter"
}
这样可在运维平台按 errorCode 快速统计各渠道失败率，定位高频问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
