• : 在 controller 上写错 service 名或方法名，客户端调用会返回 Unknown 错误。
• : 必须保证 @GrpcMethod 第一个参数与 proto 中的 service 名完全一致，第二个参数与 rpc 名完全一致。

业务实现

目前采用内存 Map 作为临时存储，创建流程包括：

1. 邮箱唯一性校验；
手机号唯一性校验；
使用 bcrypt 加密密码；
利用 nanoid 生成使用者 ID；其实，
记录 created_at / updated_at；
返回时脱敏密码。

四、gRPC 错误处理

很多开发者直接抛出 HttpException。结果在客户端只看到：“Code: Unknown Message: Internal server error”，这正是排错噩梦的根源。

import { status } from '@grpc/grpc-js';import { RpcException } from '@nestjs/microservices';if {
throw new RpcException({
从code来看。status.ALREADY_EXISTS,message: 'Email already exists',});}
}

Code: AlreadyExists Message: Email already exists

• *错误类型混淆：* HTTP 异常无法映射到 gRPC status。*方法的观点是，*统一使用 RpcException。 *
• *错误信息丢失：* 未填 message 或 code。其实，从*方法来看，*始终提供两个字段。*
• 说到*调试困难，* 没有反射工具。说到*方法，*开启 @grpc/reflection。*

/proto/order.proto:

service OrderService {
rpc CreateOrder returns;rpc GetOrder returns;}rpc GetUserOrders returns;按理说，rpc UpdateOrderStatus returns;rpc DeleteOrder returns;}

@GrpcMethod
createOrder {
return this.orderService.create;}
}

order.OrderService/CreateOrder。业务逻辑一样基于内存 Map，默认状态为 PENDING。支持按 ID 查询、按使用者 ID 查询、状态更新还有删除。

忘记在 AppModule 中导入 OrderModule → 调用时报 Unimplemented。确保每个业务模块都出现在 imports 数组中。说起来， 方法方法大小写不匹配 → 同上。未处理并发安全* → 生产环境请替换为数据库或分布式缓存。

@Module({
imports:
})
export class AppModule {}
}

如果遗漏任意一个模块。NestJS 在启动阶段不会注册对应的 GrpcHandler,客户端调用必然得到 Unimplemented。这正是许多开发者在第一次运行时遇到的“建立连接成功但方法找不到”的典型痛点。





✅ proto 中已声明 service 和 rpc
✅ controller 上 @GrpcMethod 参数精准匹配
✅ 对应 module 已放进 AppModule.imports



为了获得更好的 IDE 提示,项目额外提供了 interface 层 : 

export interface GetOrderRequest{ id:string;其实，}
export interface GetUserOrdersRequest{ user_id:string;其实，}
export interface DeleteOrderRequest{ id:string;}
这些类型与 proto 中 message 一字对应,控制器和 service 能直接获得完整类型提示。还声明了客户端接口供网关或其他服务使用 :
export interface OrderServiceClient{
createOrder: Observable;getOrder: Observable;getUserOrders: Observable;}

手动维护类型易出错 → 建议使用 proto-loader + @nestjs/microservices 自动生成 dto 接口,或采取 grpc_tools_node_protoc 生成 ts 声明文件。

八=""> 1 . proto 是契约中心 ：无论是服务端还是客户端都必须以 proto 中的 package 、service 、rpc 名称为准。

九=""> 本示例展示了如何利 用 NestJS 搭建一个同时承载 使用者服 务 和订单服 务 的 gPR C微 servicio。主要思路是的观点是，先以 proto定义清晰契约 → 再 用 @Grpmethod 把 TS方法绑定到 RPC →最终靠 模块注册确保所有 handler 被正确加载。至于还演练了，- 内存 Map 作 演示 数据层;-密码加密、唯 一性校 域及返回 脱敏；-精准 的 gRpc 错误映射；-通过反射 工具快速 调试；-多包共享及模块导入 的 常见 雷区。老实说，

若想进一步 生产 化。可按以下步骤演进： 1 .替换 内存 Map 持久 化 数据库；二 .加入 参数验证，三 .引入 JWT 或 API‑Key鉴权 中间件；四 .完善 日志链路追踪；五 .编写 UT/EUT 测试覆盖关键方法。

这样就能从 教学 性例子逐步过渡至 接近生产级别 的微 基础框架。祝大家开发顺利 🚀