C++ gRPC如何编写拦截器(Interceptor)记录请求调用日志

风枫酱_3354

风枫酱_3354

2026-11-05

689人浏览

原创

gRPC C++拦截器必须继承grpc::experimental::Interceptor并重写Intercept方法,不能用函数或lambda;需通过InterceptedChannel(客户端)或ServerBuilder::AddInterceptor(服务端)注册,且须过滤健康检查路径避免影响探针。

c++ grpc如何编写拦截器(interceptor)记录请求调用日志

gRPC C++ 拦截器必须继承 grpc::experimental::Interceptor 类

gRPC C++ 的拦截器不是通过装饰器或配置注册的,而是需要手动实现一个继承自 grpc::experimental::Interceptor 的类,并重写 Intercept 方法。这个类会在每次 RPC 调用时被实例化(除非使用 InterceptorFactory 控制生命周期),所以不能在类内保存跨调用的状态。

常见错误是试图直接实现一个普通函数或 lambda 作为拦截器——这在 C++ 版本中完全不被支持;也有人误以为继承 grpc::ClientInterceptorFactoryInterface 就够了,其实它只负责创建拦截器实例,真正干活的是 Interceptor 子类。

  • 必须包含头文件 #include
  • Intercept 方法接收 grpc::experimental::InterceptionHookPoints 枚举和一个 grpc::experimental::InterceptedMethod 对象,后者提供对 call、context、request/response 的访问入口
  • 日志记录逻辑应放在 HOOK_POINT_SEND_INITIAL_METADATA(客户端)或 HOOK_POINT_RECV_INITIAL_METADATA(服务端)等关键钩子点,而非无差别塞在所有钩子里

客户端拦截器如何获取方法名和请求参数

客户端拦截器中,方法名藏在 context->method(),但原始请求消息(如 protobuf 对象)**无法在拦截器中直接反序列化**——因为此时数据还在 buffer 阶段,尚未被解析。强行解析需复制 buffer 并调用 ParseFromArray,但会带来性能开销和线程安全风险。

更稳妥的做法是:仅记录元信息(method、host、deadline、peer、timestamp),必要时用 context->client_metadata() 提取自定义 header(如 x-request-id)辅助追踪。

  • 不要尝试在 HOOK_POINT_SEND_MESSAGE 中 cast message 参数为具体 protobuf 类型——它的类型是 const void*,且生命周期极短
  • 若真需结构化请求内容,应在业务层打日志,或改用服务端拦截器 + Deserialize 钩子(但仍有拷贝成本)
  • 推荐记录字段:context->method()、context->host()、context->deadline()、std::chrono::system_clock::now()

服务端拦截器怎么避免影响 gRPC 健康检查和探针请求

gRPC 服务端拦截器默认对所有 RPC 生效,包括 /grpc.health.v1.Health/Check 和 /grpc.reflection.v1.ServerReflection/ServerReflectionInfo 这类管理接口。如果日志逻辑里有同步 I/O(如写磁盘、发 HTTP 请求)或未捕获异常,会导致健康检查失败,进而被 k8s 误判为 crashloop。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

解决方案是在拦截器开头快速过滤掉非业务方法:

if (context->method().find("/grpc.") == 0 || context->method().find("/envoy.") == 0) {
  // 直接放行,不记录
  return;
}
  • 注意 context->method() 返回的是完整路径字符串,格式为 /package.Service/Method
  • 避免用正则匹配,简单 find 或 starts_with(C++20)即可,减少 CPU 开销
  • 若启用了 TLS,context->auth_context() 可用于区分内部调用与外部调用,但别在拦截器里做复杂鉴权

拦截器注册后没生效?检查 Channel 和 Server 的构造方式

客户端拦截器必须通过 grpc::experimental::InterceptedChannel 包装原始 Channel,否则完全不会触发;服务端拦截器则需在 ServerBuilder 中显式调用 AddInterceptor,且顺序影响执行链(多个拦截器按添加顺序从前到后执行)。

典型漏配场景:

  • 写了拦截器类,但忘记在 ServerBuilder 中调用 builder.AddInterceptor(std::make_unique())
  • 客户端用了 grpc::CreateChannel,却没套一层 grpc::experimental::InterceptedChannel
  • 服务端用了 RegisterService 后才调用 AddInterceptor —— 实际上必须在 BuildAndStart() 前完成注册
  • 拦截器对象被提前析构(比如 unique_ptr 生命周期管理错误),导致后续调用 crash

最易忽略的一点:拦截器工厂(InterceptorFactory)返回的拦截器实例,其析构时机由 gRPC 内部控制,不要在里面持有裸指针或依赖全局单例状态。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2288

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1039

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

447

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

347

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

426

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

600

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1429

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1237

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习