feat(wechat): 新增 WechatApiException 业务异常类

- 继承 RuntimeException
- code 字段使用 HTTP 风格状态码(400/500/502)
- rawBody 字段保留原始响应体用于排查
- 配套 Getter 由 Lombok @Getter 生成
This commit is contained in:
2026-06-03 22:23:40 +08:00
parent 070e7dfbd9
commit 35baa6c958
@@ -0,0 +1,33 @@
package com.emotion.exception;
import lombok.Getter;
/**
* 微信 API 业务异常
*
* <p>code 字段使用 HTTP 风格状态码:
* <ul>
* <li>400: 微信 API 业务错误(errcode != 0)或 4xx 响应</li>
* <li>500: 内部错误(JSON 解析失败)</li>
* <li>502: 上游服务错误(5xx 响应 / network / non-JSON content-type</li>
* </ul>
*
* <p>rawBody 字段仅用于服务端排查,绝不返回给前端。
*/
@Getter
public class WechatApiException extends RuntimeException {
private static final long serialVersionUID = 1L;
/** HTTP 风格状态码 */
private final Integer code;
/** 原始响应体(仅服务端排查用,绝不返回给前端) */
private final String rawBody;
public WechatApiException(Integer code, String message, String rawBody) {
super(message);
this.code = code;
this.rawBody = rawBody;
}
}