NestJS微服务异常处理与Logtail日志记录问题咨询

针对RPCException无状态码的问题，核心思路是在微服务端补充状态码信息，再让网关解析处理：

• 自定义带状态码的RPC异常：继承现有RPCException，新增statusCode属性，抛出时根据业务场景指定对应码（比如邮箱重复用409），网关捕获后直接提取状态码转成HTTP响应返回给客户端
• 用统一响应DTO替代异常：不管成功失败，微服务都返回包含code、message、data的结构化响应，网关解析后根据code映射成对应的HTTP状态码，同时返回友好提示（注意隐藏数据库内部敏感信息）

举个代码示例（以Java为例）：
微服务端自定义异常：

public class BusinessRpcException extends RPCException {
    private int statusCode;

    public BusinessRpcException(String msg, int statusCode) {
        super(msg);
        this.statusCode = statusCode;
    }

    public int getStatusCode() {
        return statusCode;
    }
}

// 业务逻辑中抛异常
if (邮箱已存在) {
    throw new BusinessRpcException("该邮箱已注册", 409);
}

网关端处理：

try {
    // 调用微服务逻辑
} catch (BusinessRpcException e) {
    return ResponseEntity.status(e.getStatusCode()).body(e.getMessage());
}

微服务和API网关两端都需要记录日志，但各有侧重：

• 微服务端：记录详细错误上下文，比如数据库SQL、请求参数、完整异常栈、链路追踪ID，方便定位微服务内部的具体错误点（比如是数据库唯一键冲突还是连接异常）
• API网关端：记录请求入口信息，比如客户端IP、请求路径、调用微服务的耗时、最终返回的HTTP状态码、错误摘要，方便排查客户端到网关的链路问题，快速区分是网关还是微服务出错

建议给每个请求生成唯一的requestId，在网关和微服务的日志中都带上这个ID，这样在Logtail中通过ID就能快速关联整个请求链路的所有日志，大幅提升排查效率。

内容的提问来源于stack exchange，提问作者Cytronic