Skip to content

v0.8.4 — 通用 Request ID Header

Latest

Choose a tag to compare

@sllhSmile sllhSmile released this 30 Sep 01:43

主要变更

  • 默认 request_id_header 从 x-b3-traceid 调整为通用关联 Header x-request-id。
  • 避免包生成的 UUID v7 被误认为符合 B3 规范的 Trace ID,提升与 B3/OpenTelemetry 链路组件协作时的语义严谨性。
  • 修正 LogMiddleware 注释,使其准确描述 Request ID 的长度、安全字符校验及无效值替换行为。
  • README 示例、配置表和 API/SDK 传播测试已同步更新。
  • 新增自定义 Header 回归测试,确认显式配置仍会被规范化并正常使用。

兼容性说明

  • 这是默认配置行为变更:未显式设置 trace_log.request_id_header 的应用,升级后将使用 x-request-id。
  • 如需保持旧 Header,可在宿主配置中显式设置 request_id_header;自定义 Header 支持保持不变。
  • PHP 最低版本仍为 8.2,Hyperf 兼容范围仍为 3.2,无依赖升级要求。

验证

  • PHPUnit:161 tests,1032 assertions,全部通过。
  • PHPStan level 8:无错误。
  • PHP CS Fixer dry-run:无格式差异。
  • git diff --check:通过。