grpc-gateway v2.27.4 版本更新介绍

发布日期: 2025-12-26
版本号: v2.27.4

本版本（v2.27.4）主要更新包括：为OpenAPI参数添加了deprecated字段支持；修复了OpenAPIv2中使用body字段时schema的required数组无效、嵌套required字段错误提升至父schema、以及严格no-$ref-siblings规则违反等问题；将Dockerfile中的OpenJDK版本升级；排除了没有HTTP绑定的方法在OpenAPI定义中的生成；增加了关于Authorization头转发的说明；并修复了gengateway在opaque API模式下body字段解码的错误。此外，lachlancooper、rdark、jgreffe、MicahParks 等4位开发者进行了首次贡献。完整变更日志可查看v2.27.3至v2.27.4的比较。

更新内容 （中文）

更新内容

• 功能：为OpenAPI参数添加对已弃用字段的支持（由 @lachlancooper 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6068 中贡献）
• 修复(openapiv2)：使用 body: "field_name" 时，请求体参数模式中 required 数组包含无效条目（由 @rdark 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6088 中贡献）
• 修复(openapiv2)：防止嵌套的 required 字段被提升至父级模式（由 @rdark 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6078 中贡献）
• [问题-6080] 修复严格的 no-$ref-siblings 规则违规（由 @jgreffe 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6099 中贡献）
• Dockerfile：升级 openjdk 版本（由 @johanbrandhorst 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6130 中贡献）
• 修复：将无HTTP绑定的方法排除在OpenAPI定义之外（由 @iamrajiv 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6030 中贡献）
• 添加关于Authorization头转发的说明（由 @MicahParks 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6185 中贡献）
• 修复(gengateway)：在opaque API模式下修正body字段解码（由 @kop 在 https://github.com/grpc-ecosystem/grpc-gateway/pull/6197 中贡献）

新贡献者

• @lachlancooper 在其首个贡献中参与了 https://github.com/grpc-ecosystem/grpc-gateway/pull/6068
• @rdark 在其首个贡献中参与了 https://github.com/grpc-ecosystem/grpc-gateway/pull/6088
• @jgreffe 在其首个贡献中参与了 https://github.com/grpc-ecosystem/grpc-gateway/pull/6099
• @MicahParks 在其首个贡献中参与了 https://github.com/grpc-ecosystem/grpc-gateway/pull/6185

完整更新日志: https://github.com/grpc-ecosystem/grpc-gateway/compare/v2.27.3...v2.27.4

更新内容 （原始）

What’s Changed

• feat: support deprecated field for OpenAPI parameters by @lachlancooper in https://github.com/grpc-ecosystem/grpc-gateway/pull/6068
• fix(openapiv2): Invalid entries in body parameter schema required array when using body: "field_name" by @rdark in https://github.com/grpc-ecosystem/grpc-gateway/pull/6088
• fix(openapiv2): prevent nested required fields hoisting to parent schema by @rdark in https://github.com/grpc-ecosystem/grpc-gateway/pull/6078
• [issue-6080] Fix strict no-$ref-siblings rule violations by @jgreffe in https://github.com/grpc-ecosystem/grpc-gateway/pull/6099
• Dockerfile: upgrade openjdk version by @johanbrandhorst in https://github.com/grpc-ecosystem/grpc-gateway/pull/6130
• fix: Exclude methods without HTTP bindings from OpenAPI definitions by @iamrajiv in https://github.com/grpc-ecosystem/grpc-gateway/pull/6030
• Add note about Authorization header forwarding by @MicahParks in https://github.com/grpc-ecosystem/grpc-gateway/pull/6185
• fix(gengateway): correct body field decoding in opaque API mode by @kop in https://github.com/grpc-ecosystem/grpc-gateway/pull/6197

New Contributors

• @lachlancooper made their first contribution in https://github.com/grpc-ecosystem/grpc-gateway/pull/6068
• @rdark made their first contribution in https://github.com/grpc-ecosystem/grpc-gateway/pull/6088
• @jgreffe made their first contribution in https://github.com/grpc-ecosystem/grpc-gateway/pull/6099
• @MicahParks made their first contribution in https://github.com/grpc-ecosystem/grpc-gateway/pull/6185

Full Changelog: https://github.com/grpc-ecosystem/grpc-gateway/compare/v2.27.3...v2.27.4

下载链接

• grpc-gateway-v2.27.4.tar.gz
• grpc-gateway_2.27.4_checksums.txt
• multiple.intoto.jsonl
• protoc-gen-grpc-gateway-v2.27.4-darwin-arm64
• protoc-gen-grpc-gateway-v2.27.4-darwin-x86_64
• protoc-gen-grpc-gateway-v2.27.4-linux-arm64
• protoc-gen-grpc-gateway-v2.27.4-linux-x86_64
• protoc-gen-grpc-gateway-v2.27.4-windows-arm64.exe
• protoc-gen-grpc-gateway-v2.27.4-windows-x86_64.exe
• protoc-gen-openapiv2-v2.27.4-darwin-arm64
• protoc-gen-openapiv2-v2.27.4-darwin-x86_64
• protoc-gen-openapiv2-v2.27.4-linux-arm64
• protoc-gen-openapiv2-v2.27.4-linux-x86_64
• protoc-gen-openapiv2-v2.27.4-windows-arm64.exe
• protoc-gen-openapiv2-v2.27.4-windows-x86_64.exe