在 nestjs 服务中，应避免将业务逻辑异常（如资源未找到）与底层错误（如数据库连接失败）混入同一 catch 块；推荐使用 promise.catch() 拦截底层异常，再对业务状态做显式判断，确保 404 和 500 状态码精准分离。
在 nestjs 服务中，应避免将业务逻辑异常（如资源未找到）与底层错误（如数据库连接失败）混入同一 catch 块；推荐使用 promise.catch() 拦截底层异常，再对业务状态做显式判断，确保 404 和 500 状态码精准分离。
在 NestJS 应用中，合理区分业务异常（例如“ID 对应资源不存在”）和系统异常（例如数据库查询失败、网络超时）至关重要。若统一用 try...catch 包裹异步操作，会导致所有 throw（包括主动抛出的 HttpException(404)）都被捕获并降级为 500，违背 REST 语义。
✅ 推荐写法：分离关注点，用 .catch() 专责处理底层 Promise 拒绝，再对查询结果做业务校验：
async fetchItem(id: string): Promise<item> {
// 仅捕获底层异常（如 DB 连接失败、语法错误、超时等）
const item = await this.ItemsRepository.findOneBy({ id })
.catch(err => {
console.error('Database query failed for item ID:', id, err);
throw new HttpException(
'Failed to retrieve item due to internal error',
HttpStatus.INTERNAL_SERVER_ERROR
);
});
// 业务逻辑判断：资源不存在 → 主动抛出 404
if (!item) {
throw new HttpException(
`Item with ID "${id}" was not found`,
HttpStatus.NOT_FOUND
);
}
return item;
}</item>
⚠️ 注意事项：
- 不要在 try 中抛出业务异常后依赖 catch 分发状态码：try...catch 会无差别捕获所有 throw，使 404 被误转为 500；
- .catch() 仅响应 Promise rejection：findOneBy() 在查询失败（如 DB 异常）时 reject，而返回 null/undefined 是正常 resolved 值，不会触发 .catch()；
- 日志建议：在 .catch() 中记录原始错误详情（含堆栈），便于运维排查；业务性 404 可选择不记 error 级别日志，避免日志污染；
-
类型安全增强（可选）：结合 NotFoundException（NestJS 内置）提升语义清晰度：
if (!item) throw new NotFoundException(`Item with ID "${id}"`);
? 总结：NestJS 异常处理的核心原则是——让错误各归其位。底层技术故障走 catch / Promise.catch() 映射为 500；业务规则不满足（如资源缺失、权限不足）通过同步条件判断主动抛出对应 HttpException 或内置异常类（如 NotFoundException, ForbiddenException），由全局异常过滤器（@Catch()）统一格式化响应。这种分层设计既保障 HTTP 状态码语义准确，又利于监控告警与前端容错处理。
