java自定义异常无法自动跨服务传递错误码，必须主动将错误码封装进http响应体；应统一定义errorcode枚举并在全局异常处理器中转为结构化json响应，调用方需解析code字段映射本地异常。
在微服务中，Java 自定义异常本身不会自动跨服务传递错误码，因为异常对象无法直接序列化穿透 HTTP 或 RPC 边界。真正能被下游服务识别和处理的，是**你主动封装并写入响应体（或响应头）的错误码**。关键不在于“抛什么异常”，而在于“怎么把错误码发出去”。
统一定义业务错误码
避免各服务各自为政。建议在公共模块（如 common-error）中定义枚举：
- ErrorCode：包含 code（int 或 String）、message、httpStatus 等字段；
- 例如：
USER_NOT_FOUND(40001, "用户不存在", HttpStatus.NOT_FOUND)； - 所有自定义异常（如
UserNotFoundException）构造时关联一个ErrorCode。
在当前服务中：异常 → 标准响应
用全局异常处理器（@ControllerAdvice）拦截自定义异常，转为结构化 JSON 响应：
- 响应体通常含：
{"code": 40001, "message": "用户不存在", "timestamp": "...", "path": "/api/user/123"}； - 同时设置 HTTP 状态码（如
HttpStatus.NOT_FOUND），便于网关或客户端判断； - 不要只靠状态码——很多业务错误都用
400或500，必须靠code字段区分具体业务含义。
在调用方服务中：解析响应 → 转回本地异常（可选）
下游服务收到 HTTP 响应后，需主动检查 code 字段，而不是依赖原始异常类：
- Feign 客户端可配
ErrorDecoder，根据响应中的code创建对应本地自定义异常（如new UserNotFoundException()）； - RestTemplate 或 WebClient 需手动判断
response.getStatusCode()和解析 body 中的code，再 throw 本地异常； - 注意：远程异常类名、包路径在调用方不存在，不能反序列化原始异常对象。
跨语言或网关场景：只传标准字段
如果微服务涉及 Go、Python 等其他语言，或经过 API 网关，更需严格遵守契约：
- 错误码统一用整数或短字符串（如
"AUTH_INVALID_TOKEN"），避免 Java 包名或类名； - 错误信息只作提示，不用于程序逻辑判断；
- 网关可基于
code做统一日志记录、告警或降级，无需理解 Java 异常体系。
不复杂但容易忽略：异常是开发期的便利工具，跨服务通信靠的是协议和数据格式。把错误码放进响应体，比让异常“飞过去”更可靠、更通用。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
