云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载Tekton Pipeline 仓库通过 vendor 机制内置了 Go REST 框架 go-restful 的完整实现本仓库锁定版本为 v3.13.0。本文以 vendored 目录中的变更历史 CHANGES.md 为主线完整梳理该框架从 2012 年初次提交到 2025 年 v3.13.0 的全部版本脉络并结合仓库中实际存在的源码文件CurlyRouter、CORS 过滤器、内容编码等模块印证每一条变更记录背后的实现落点帮助你理解这个间接依赖的架构演进逻辑与安全加固历程。为什么 Tekton Pipeline 会 vendor 一个 REST 框架Tekton Pipeline 的核心是 Kubernetes 控制器cmd/controller、Webhookcmd/webhook与各类 reconcilerpkg/reconciler其对外通信主要走 Kubernetes API 与 gRPC而非自行搭建 HTTP 服务。在 go.mod 中可以确认该依赖的声明github.com/emicklei/go-restful/v3 v3.13.0 // indirect两个关键事实标记为// indirect仓库自身源码没有直接import它对cmd、pkg、internal、test目录检索均未发现直接导入语句它是经由 knative.dev/pkg、kube-openapi 等 k8s 生态传递依赖引入的go.sum 中同时保留了 v2.9.5incompatible 与 v3.13.0 的哈希记录说明依赖图在不同时期引用过 v1/v2 旧路径最终收敛到 v3 模块路径github.com/emicklei/go-restful/v3——这一点与 changelog 中 v3.0.0 条目模块消费方应使用 v3 作为 import 路径的说明完全对应。正因为它是被传递依赖钉在 v3.13.0 的理解这个版本的变更史对于排查由上游依赖升级引发的行为变化尤其是路径匹配与 CORS 行为有直接价值。下文以 changelog 原文为准逐段展开。完整版本时间线按 changelog 原样继承为保证信息不缩水这里先给出与 CHANGES.md 逐条对应的完整版本表再分阶段深入。v3.x 阶段2022–2025模块时代版本日期变更记录changelog 原文要点v3.13.02025-08-14优化 CurlyRouter 的路径匹配性能thanks wenhuang, Wen Huangv3.12.22025-02-21允许 post/put/patch 使用空 payloadissue #580thanks liggitt, Jordan Liggittv3.12.12024-05-28修复多 WebService 场景下正则导致的误路由#549thanks Haitao Chenv3.12.02024-03-11新增 Flush 方法#529/#538修复空 POST 请求处理不当#543v3.11.32024-01-09避免在一个 commit 上打两个 tag发版流程修正v3.11.1 / v3.11.22024-01-09恢复自定义 JSON handler 函数Mike Beaumont#540v3.11.02023-08-19恢复 ≤v3.9.0 的行为并提供TrimRightSlashEnabled选项改变路径策略v3.10.22023-03-09DO NOT USE。引入 MergePathStrategy可将路径拼接行为回退到 3.9.0v3.10.12022-11-19DO NOT USE。用 path 包拼接路径以修复 3.10.0 的损坏v3.10.02022-10-11BROKEN。修改 tokenizer 以匹配标准路由行为、不再 trimright 路径#511新增 MIME_ZIP#512、HEADER_ContentDisposition#513修改获取 query 参数的方式#510v3.9.02022-07-21支持 http.Handler 实现作为 FilterFunctionissue #504thanks ggicciv3.8.02022-06-06CORS AllowedDomains 改为精确匹配#489/#493修复用户可控 Key 导致的授权绕过安全漏洞并新增AllowedDomainFunc回调以兼容旧行为补充无 body、无 Content-type 的 POST 测试与修复#492/#496修正 receiver 类型混用的坏实践#491v3.7.22021-11-24恢复 FilterChain#482by SVilgelmv3.7.12021-10-04修复 contentEncodingEnabled 设置问题#479v3.7.02021-09-24parameter 增加额外 OpenAPI 映射#478v3.6.02021-09-18支持 vendor extensions#477thx erraggyv3.5.22021-07-14修复从 webservice 中移除不存在 route 的问题#472v3.5.12021-04-12修复 no match 时对 access selected path 的处理移除废弃字段v3.5.02021-04-10CORS 增加通配符wildcard检查#463Request 可访问命中的 Routeissue #459/#462v3.4.02020-11-10WebService 支持 OPTIONSv3.3.22020-01-23修复 dispatch 中重复压缩的问题#449v3.3.12020-08-31对 writer 增加检查防止响应被压缩两次#447v3.3.02020-08-19在 Handle 与 ServeHTTP 中启用内容编码#446406 响应体中列出可用 representation#437使用 rune() 转 string#443v3.2.02020-06-21405 Method Not Allowed 响应必须携带 Allow 头#436新增 allowedMethodsWithoutContentType 字段#424v3.1.02020-06-?支持描述 response headers#426修复 openapi examples#425v3.0.02019-12-?修复使用 filter chain 产生的 request/response新增 Go module 支持import 路径变为github.com/emicklei/go-restful/v3v2.x 阶段2017–2019默认行为定型期版本/日期变更记录changelog 原文要点v2.11.1修复 WriteError 返回值#415v2.11.0路径变量表达式支持前后缀#414即prefix_{var}与{var}_suffix写法v2.10.0支持自定义动词Custom Verbsthanks Vinci Xu修复静态示例简化代码新增 JWT HMAC-SHA-512 认证示例v2.9.6出现两次一次是 filter 代码的小优化另一次是支持 google 自定义动词#413v2.9.5修复Response.WriteError在 err nil 时的 panicv2.9.4修复 mime type quality 解析issue #400RouteBuilder 增加 contentEncodingEnabled 选项#398v2.9.3请求 body 为空时不再误返 415 Unsupported Media Type#396v2.9.2减少 per-request 方法中的分配以改善性能#395v2.9.1修复默认响应与非法状态码 0 的问题#393v2.9.0新增 per-Route 内容编码设置覆盖 container 级设置v2.8.0新增Request.QueryParameters()通过 build tag 支持 json-iterator禁用 vgo 模块v2.7.1新增 vgo 模块v2.6.1新增 JSONNewDecoderFunc允许自定义 JSON Decodergo 1.10v2.6.0JSR311 路由与路径参数处理保持一致RouteBuilder.Reads()增加 description更新 Swagger12 与 OpenAPI 示例2017-09-13路由构建支持条件函数.If(func)2017-02-16解决 issue #304使 operation 名称唯一2017-01-30重要swagger 用户 import 改为swagger github.com/emicklei/go-restful-swagger12swagger 1.2 代码移出主包打 TAG 2.0.02017-01-27移除 request body 的 defer close暴露 Dispatch 便于测试 filter 与 RouteFunctionswagger 响应模型不能是数组打 TAG 1.0.02016-12-22API 变更移除请求内容缓存相关代码删除SetCacheReadEntity(doCache bool)2016-11-26默认行为三连变默认路由改为 CurlyRouter原为 RouterJSR311不再缓存请求内容不再从 panic 中恢复2016-09-22修复 DefaultRequestContentType 特性2016-02-14决定响应 contenttype 时纳入 Accept 头 mediatype 的 quality 因子为 xml/json 实体访问器新增构造器早期形成期2012-11 2015日期变更记录changelog 原文要点2015-09-27WriteStatusAnd...重命名为WriteHeaderAnd...保持一致性2015-09-25修复 WriteHeader 之后修改 Header 失效的问题issue 2352015-09-14改变WriteHeader立即写出与WriteEntity不再写状态的行为语义支持自定义 EntityReaderWriters2015-08-06支持读取压缩后的请求内容请求/响应压缩器改用 sync.PoolParameter 增加 Description 用于 Swagger UI2015-03-20增加可配置日志2015-03-18未显式指定时Operation 从 Route 函数名推导2015-03-17暴露 Parameter 创建函数trace logger 改为接口修复 OPTIONSFilter可自定义 ServiceError 渲染JSR311 路由支持通配符Route 增加 Notes2014-11-27新增 per-response PrettyPrint#1672014-11-12新增ApiVersion(.)用于 Swagger UI 文档2014-11-10API 变更带 description tag 的 struct 字段会显示在 Swagger UI2014-10-31ReturnsError更名为Returns新增RouteBuilder.Do(aBuilder)便于复用修复 swagger 嵌套 struct按 code 排序 swagger 响应2014-10-23新增ReturnsError用于在 swagger 中记录 HTTP 码修复 CurlyRouter 的贪婪匹配问题CORS 增加 Access-Control-Max-Age新增可注入的 tracing 调试功能JSON 解析支持 64 位整型修复 swagger 空参数WebServiceUrl 对 swagger 变为可选修复 CORS 重复的 AccessControlAllowOrigincontainer 暴露 ServeMuxCORS 新增 AllowedDomains新增 ParameterNamed 用于细化文档2014-07-03CORS 可配置允许域列表2014-06-27ParameterNamed 提供 Parameter 定义及其数据SetCacheReadEntity控制请求 body 是否被缓存当时默认 true 以兼容2014-04-16暴露 Request 构造器便于测试2014-04-15修复v1.0.1 tag修复 Issue 111WriteErrorString2014-03-12路由路径参数支持通配符与正则表达式需配合 CurlyRouter2014-02-26Request 提供所命中 Route 的信息见方法SelectedRoutePath2014-02-17重命名参数常量go-lint 检查2014-01-10支持 CloseNotify2014-01-07Response 的 Write* 方法改为返回 error 或 nil新增 HTML Go template 示例CORS Allowed 头比较改为大小写不敏感2013-11-13Response 可感知已写出的字节数2013-10-29新增RecoverHandler(handler RecoverHandleFunction)定制 panic 恢复行为默认打日志并返回 stacktrace作者提示这可能是安全隐患因为暴露源码信息2013-10-04Response 可感知已写出的 HTTP 状态码Request 支持 attributesstring-interface 映射即 request 级变量2013-09-12API 变更Router 接口简化实现 CurlyRouter——一个不在路径中使用/允许正则的路由器2013-08-27修复若干已报告问题API 变更弃用 WriteError改用 WriteErrorString2013-08-08新增 Container 实现带独立 http.ServeMux 的 WebServices 集合支持一个程序多端点已有用法会注册到 DefaultContainerswagger 包扩展为每 container 一套 UIpanic 时打印短 stack traceResponse 新增 WriteErrorString。API 移除包变量 DoNotRecover 与 EnableContentEncoding 失效改用restful.DefaultContainer.DoNotRecover(true)/EnableContentEncoding(true)2013-08-05新增 OPTIONS 支持与 CORS 支持2013-07-06新增响应编码gzip 与 deflate/zlib支持默认关闭以保持向后兼容2013-06-19改进DoNotRecover 选项、request body 位置优化、改进 ReadEntity2013-06-03API 变更移除 Dispatcher 接口隐藏 PathExpressionreceiver 命名改为更地道的 Go 风格2013-06-02优化缓存路径的 RegExp 编译结果2013-05-22新增请求/响应 filter 函数支持2013-05-18API 变更允许更换默认 Http Request Dispatch 函数Swagger Webservice 移入 swagger 包2012-11-14初始提交阶段一框架骨架的成型2012-11 2013changelog 显示 go-restful 于 2012-11-14 完成初始提交半个月内即具备可用的核心结构。2013 年上半年密集补齐了后续所有版本都依赖的三大基础设施Filter 机制2013-05-22请求/响应 filter 是整个框架的拦截层后续 CORS 过滤器、OPTIONS 自动响应、panic 恢复、内容编码全部构建在这条链上。vendor 目录中对应 filter.go 与 filter_adapter.go后者正是 2013-05-18 允许更换默认 Dispatch 函数的落点——把任意 http.Handler 适配为 filter 的HttpMiddlewareHandlerToFilter能力。CurlyRouter2013-09-12changelog 原文称其为a Router that does not use|allow regular expressions in paths即把路径参数从正则表达式驱动改为{id}花括号 token 驱动并同步简化了 Router 接口。实现即 curly.go、curly_route.go接口定义在 router.go。同年 10-23 记录的修复贪婪 CurlyRouter说明早期版本存在静态段与动态段抢占的匹配缺陷。Container 抽象2013-08-08引入带独立http.ServeMux的 WebServices 集合支撑一个进程多个端点。这是本次架构上最大的一步包级开关DoNotRecover、EnableContentEncoding被移除改为restful.DefaultContainer.DoNotRecover(true)之类的实例方法。vendor 中的 web_service_container.go 与 container.go 即是这一设计的最终形态。同期还落地了内容编码2013-07-06gzip/deflate默认关闭对应 compress.go、compressor_cache.go、compressor_pools.go与 OPTIONS/CORS2013-08-05对应 options_filter.go、cors_filter.go。阶段二v2 时代的三次默认行为转折2014 20172014 年的改动以 API 增补为主ParameterNamed、Returns/ReturnsError、SelectedRoutePath、CloseNotify、PrettyPrint、ApiVersion 等多数服务于 Swagger 文档生成这一当时的主要场景。值得单独指出的是 2014-10-23 条目ReturnsError先加入、2014-10-31 又更名为Returns属于短期内两次 API 调整。2016-11-26 是全 changelog 信息量最大的一条三项默认行为同日变更默认路由从 RouterJSR311 换成CurlyRouter——与 jsr311.go 并存两套路由器同时保留至今不再缓存请求内容配套 2016-12-22 彻底移除SetCacheReadEntity默认不再从 panic 中恢复配合 2013-10-29 引入的RecoverHandler定制点把恢复策略交还给使用者。2017-01-30 完成了与 swagger 1.2 代码的切割swagger 相关代码移入独立的 go-restful-swagger12 包主库只保留 OpenAPI 声明能力配合 route.go 中Returns/Writes等文档元数据 API并打出 2.0.0 tag。此后 v2.8.0v2.11.x 主要是打磨QueryParameters()、json-iterator build tag、per-Route 内容编码、空 body 不返回 415v2.9.3#396、路径变量前后缀v2.11.0#414对应 path_expression.go 的正则支持、google 自定义动词v2.9.6#413对应 custom_verb.go。阶段三v3 模块时代与安全加固2019 2025v3.0.0 的两个要点修复必须使用 filter chain 中最终产生的 request/response以及正式接入 Go Modulesimport 路径加/v3后缀。这也是本仓库 go.mod 采用github.com/emicklei/go-restful/v3路径的原因。路径拼接策略的风波v3.10.x 的连续翻车与 v3.11.0 的收敛v3.10 系列是这份 changelog 中最罕见的版本状态标注案例值得完整还原v3.10.02022-10-11标注 BROKEN为了对齐标准路由行为tokenizer 不再 trimright 路径#511同时混入了 MIME_ZIP#512/#513与 query 参数获取方式变更#510v3.10.12022-11-19与 v3.10.22023-03-09均标注 DO NOT USE前者用path包重写路径拼接仍不完整后者引入MergePathStrategy提供回退手段但作者仍判定不可用v3.11.02023-08-19收敛恢复 ≤v3.9.0 的行为并保留包级变量TrimRightSlashEnabledREADME 明确其默认为 true作为改变斜杠匹配策略的开关。这条线索的工程启示在于跨 minor 版本的路径匹配行为变更可能悄悄改变路由命中结果升级 REST 框架类依赖时路径拼接与尾斜杠处理是必须回归测试的面。本仓库锁定 v3.13.0已处于该风波收敛之后的稳定线上。CORS 安全加固v3.8.0 的授权绕过修复v3.8.02022-06-06条目原文use exact matching of allowed domain entries, issue #489 (#493) — this changes fixes [security] Authorization Bypass Through User-Controlled Key by changing the behaviour of the AllowedDomains setting in the CORS filter. To support the previous behaviour, the CORS filter type now has a AllowedDomainFunc callback mechanism which is called when a simple domain match fails.这是本次历史中唯一明确冠以security的条目AllowedDomains 由宽松的域匹配改为精确匹配规避用户可控 key 导致的授权绕过同时新增AllowedDomainFunc回调简单匹配失败时再走自定义逻辑保证向后兼容。实现位于 vendor 中的 cors_filter.go。与之呼应的后续改进包括 v3.5.0 的 CORS 通配符检查#463以及 2014-01-07 更早的Allowed 头比较改为大小写不敏感。空请求体处理一个跨越十年的反复修复主题changelog 中至少有四处围绕空 body / 无 Content-Type 请求的修复v2.9.32017请求 body 为空时不再误返 415 Unsupported Media Type#396v3.8.0补测并修复无 body、无 Content-type 的 POST#492/#496v3.12.02024-03-11修复Improper handling of empty POST requests#543v3.12.22025-02-21正式允许 post/put/patch 携带空 payloadissue #580。这说明 REST 框架对合法但极简请求的容错是一个持续暴露、持续修补的边界若基于该框架构建服务空 body 的 PUT/PATCH 语义升级后才会完全放开。性能优化谱系按 changelog 可拼出一条清晰的路径匹配性能演进线2013-06-02缓存路径 RegExp 编译结果正则缓存自此成为默认能力README 提到可用SetPathTokenCacheEnabled、SetCustomVerbCacheEnabled关闭默认 truev2.9.2#395减少 per-request 方法中的内存分配2015-08-06请求/响应压缩器改用 sync.Pool对应 compressor_pools.gov3.13.02025-08-14本仓库锁定版本优化 CurlyRouter 路径匹配性能——这是 vendored 代码 curly.go / curly_route.go 中当前生效的匹配算法版本。序列化与 OpenAPI 文档能力的扩展自定义 JSON 处理链v2.6.1 引入JSONNewDecoderFuncv2.8.0 通过 build tag 支持 json-iteratorv3.11.1/v3.11.2 专门恢复自定义 JSON handler 函数#540v3.11.0 的 tokenizer 改动曾误伤该能力两个补丁版本 v3.11.3 的避免双 tag共同构成了快速回滚-重发的发版节奏。实体序列化基础在 entity_accessors.go2015-09-14 起支持注册自定义 EntityReaderWriters。OpenAPI 声明v2.6.0 统一 JSR311 路由与路径参数文档一致性v3.6.0 支持 vendor extensions#477v3.7.0 扩展 parameter 的 OpenAPI 映射#478v3.1.0 支持描述响应头#426并修复 examples#425。参数文档 API 位于 parameter.go。错误与响应语义v3.2.0 强制 405 响应携带 Allow 头#436并引入allowedMethodsWithoutContentType#424v3.3.0 让 406 响应体列出可用 representation#437错误渲染基础是 service_error.go。扩展点补齐v3.9.0 允许把任意 http.Handler 实现当 FilterFunction 使用#504v3.12.0 为 response.go 增加 Flush 方法#529/#538服务于流式/分块响应场景。在 Tekton Pipeline 仓库中验证这份变更史如果你想把 changelog 条目与 vendored 源码一一对照可直接浏览 vendor/github.com/emicklei/go-restful/v3 目录其文件布局与功能条目高度对应路由层router.goRouter 接口、curly.go默认 CurlyRouter、jsr311.go、path_expression.go、custom_verb.gov2.10.0 的自定义动词服务层web_service.goWebService 与 Route 注册、web_service_container.goContainer、options_filter.gov3.4.0 的 OPTIONS 支持请求/响应与编码request.go、response.go、entity_accessors.go、compress.go 及压缩器池横切能力cors_filter.go、mime.go、logger.go2015-03-20 的可配置日志与 log/log.go。需要注意的适用前提该目录是 vendor 快照内容对应 go.sum 中固定的 v3.13.0 哈希不随上游 master 分支变化Tekton 侧不直接调用这些 API其价值主要体现在依赖审计、安全通告排查例如核对 v3.8.0 CORS 修复是否已包含在本快照中以及理解 k8s 生态传递依赖的行为边界。总结CHANGES.md 虽只有百余行却完整记录了一个 Go REST 框架十三年间的三条主线路由算法JSR311 → CurlyRouter 默认化 → v3.10.x 路径拼接风波 → v3.13.0 匹配性能优化、安全与合规CORS 精确匹配与 AllowedDomainFunc 回调、405 必须带 Allow 头、序列化与文档扩展自定义 JSON handler、OpenAPI vendor extensions、per-Route 内容编码。对维护 Tekton Pipeline 这类以 Kubernetes 生态依赖为主的仓库而言读懂依赖的 changelog 是升级决策前的必要功课——尤其是本仓库锁定的 v3.13.0 正处于 CurlyRouter 性能优化的最新版本而 v3.10.0~v3.10.2 被作者亲自标注 BROKEN / DO NOT USE 的先例正是跨版本路径匹配行为不可默认兼容的最佳注脚。赞分享云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载相关推荐go-restful v3 演进全解析从 CHANGES.md 与源码读懂 REST 框架的十年设计变迁go restful v3 演进全解析从 CHANGES.md 与源码读懂 REST 框架的十年设计变迁 本文以当前仓库中 vendored 的 go res云原生CLI应用安全RetroArch 版本演进深度解析从 CHANGES.md 看 libretro 前端的十年技术积累RetroArch 版本演进深度解析从 CHANGES.md 看 libretro 前端的十年技术积累 导读 CHANGES.md https://link.游戏开发跨平台音视频从 CHANGES.md 看 gax-go v2 演进Sliver 仓库中 Google API 调用基础设施的完整解析从 CHANGES.md 看 gax go v2 演进Sliver 仓库中 Google API 调用基础设施的完整解析 导读 本文以 Sliver 仓库网络安全上一篇ParquetViewer突破Windows平台数据查看限制让Parquet文件处理效率提升10倍下一篇Python CAN工具(cantools)实战指南从问题到解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从 CHANGES.md 看 Tekton Pipeline 仓库中 go-restful v3 的十年演进史
云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载Tekton Pipeline 仓库通过 vendor 机制内置了 Go REST 框架 go-restful 的完整实现本仓库锁定版本为 v3.13.0。本文以 vendored 目录中的变更历史 CHANGES.md 为主线完整梳理该框架从 2012 年初次提交到 2025 年 v3.13.0 的全部版本脉络并结合仓库中实际存在的源码文件CurlyRouter、CORS 过滤器、内容编码等模块印证每一条变更记录背后的实现落点帮助你理解这个间接依赖的架构演进逻辑与安全加固历程。为什么 Tekton Pipeline 会 vendor 一个 REST 框架Tekton Pipeline 的核心是 Kubernetes 控制器cmd/controller、Webhookcmd/webhook与各类 reconcilerpkg/reconciler其对外通信主要走 Kubernetes API 与 gRPC而非自行搭建 HTTP 服务。在 go.mod 中可以确认该依赖的声明github.com/emicklei/go-restful/v3 v3.13.0 // indirect两个关键事实标记为// indirect仓库自身源码没有直接import它对cmd、pkg、internal、test目录检索均未发现直接导入语句它是经由 knative.dev/pkg、kube-openapi 等 k8s 生态传递依赖引入的go.sum 中同时保留了 v2.9.5incompatible 与 v3.13.0 的哈希记录说明依赖图在不同时期引用过 v1/v2 旧路径最终收敛到 v3 模块路径github.com/emicklei/go-restful/v3——这一点与 changelog 中 v3.0.0 条目模块消费方应使用 v3 作为 import 路径的说明完全对应。正因为它是被传递依赖钉在 v3.13.0 的理解这个版本的变更史对于排查由上游依赖升级引发的行为变化尤其是路径匹配与 CORS 行为有直接价值。下文以 changelog 原文为准逐段展开。完整版本时间线按 changelog 原样继承为保证信息不缩水这里先给出与 CHANGES.md 逐条对应的完整版本表再分阶段深入。v3.x 阶段2022–2025模块时代版本日期变更记录changelog 原文要点v3.13.02025-08-14优化 CurlyRouter 的路径匹配性能thanks wenhuang, Wen Huangv3.12.22025-02-21允许 post/put/patch 使用空 payloadissue #580thanks liggitt, Jordan Liggittv3.12.12024-05-28修复多 WebService 场景下正则导致的误路由#549thanks Haitao Chenv3.12.02024-03-11新增 Flush 方法#529/#538修复空 POST 请求处理不当#543v3.11.32024-01-09避免在一个 commit 上打两个 tag发版流程修正v3.11.1 / v3.11.22024-01-09恢复自定义 JSON handler 函数Mike Beaumont#540v3.11.02023-08-19恢复 ≤v3.9.0 的行为并提供TrimRightSlashEnabled选项改变路径策略v3.10.22023-03-09DO NOT USE。引入 MergePathStrategy可将路径拼接行为回退到 3.9.0v3.10.12022-11-19DO NOT USE。用 path 包拼接路径以修复 3.10.0 的损坏v3.10.02022-10-11BROKEN。修改 tokenizer 以匹配标准路由行为、不再 trimright 路径#511新增 MIME_ZIP#512、HEADER_ContentDisposition#513修改获取 query 参数的方式#510v3.9.02022-07-21支持 http.Handler 实现作为 FilterFunctionissue #504thanks ggicciv3.8.02022-06-06CORS AllowedDomains 改为精确匹配#489/#493修复用户可控 Key 导致的授权绕过安全漏洞并新增AllowedDomainFunc回调以兼容旧行为补充无 body、无 Content-type 的 POST 测试与修复#492/#496修正 receiver 类型混用的坏实践#491v3.7.22021-11-24恢复 FilterChain#482by SVilgelmv3.7.12021-10-04修复 contentEncodingEnabled 设置问题#479v3.7.02021-09-24parameter 增加额外 OpenAPI 映射#478v3.6.02021-09-18支持 vendor extensions#477thx erraggyv3.5.22021-07-14修复从 webservice 中移除不存在 route 的问题#472v3.5.12021-04-12修复 no match 时对 access selected path 的处理移除废弃字段v3.5.02021-04-10CORS 增加通配符wildcard检查#463Request 可访问命中的 Routeissue #459/#462v3.4.02020-11-10WebService 支持 OPTIONSv3.3.22020-01-23修复 dispatch 中重复压缩的问题#449v3.3.12020-08-31对 writer 增加检查防止响应被压缩两次#447v3.3.02020-08-19在 Handle 与 ServeHTTP 中启用内容编码#446406 响应体中列出可用 representation#437使用 rune() 转 string#443v3.2.02020-06-21405 Method Not Allowed 响应必须携带 Allow 头#436新增 allowedMethodsWithoutContentType 字段#424v3.1.02020-06-?支持描述 response headers#426修复 openapi examples#425v3.0.02019-12-?修复使用 filter chain 产生的 request/response新增 Go module 支持import 路径变为github.com/emicklei/go-restful/v3v2.x 阶段2017–2019默认行为定型期版本/日期变更记录changelog 原文要点v2.11.1修复 WriteError 返回值#415v2.11.0路径变量表达式支持前后缀#414即prefix_{var}与{var}_suffix写法v2.10.0支持自定义动词Custom Verbsthanks Vinci Xu修复静态示例简化代码新增 JWT HMAC-SHA-512 认证示例v2.9.6出现两次一次是 filter 代码的小优化另一次是支持 google 自定义动词#413v2.9.5修复Response.WriteError在 err nil 时的 panicv2.9.4修复 mime type quality 解析issue #400RouteBuilder 增加 contentEncodingEnabled 选项#398v2.9.3请求 body 为空时不再误返 415 Unsupported Media Type#396v2.9.2减少 per-request 方法中的分配以改善性能#395v2.9.1修复默认响应与非法状态码 0 的问题#393v2.9.0新增 per-Route 内容编码设置覆盖 container 级设置v2.8.0新增Request.QueryParameters()通过 build tag 支持 json-iterator禁用 vgo 模块v2.7.1新增 vgo 模块v2.6.1新增 JSONNewDecoderFunc允许自定义 JSON Decodergo 1.10v2.6.0JSR311 路由与路径参数处理保持一致RouteBuilder.Reads()增加 description更新 Swagger12 与 OpenAPI 示例2017-09-13路由构建支持条件函数.If(func)2017-02-16解决 issue #304使 operation 名称唯一2017-01-30重要swagger 用户 import 改为swagger github.com/emicklei/go-restful-swagger12swagger 1.2 代码移出主包打 TAG 2.0.02017-01-27移除 request body 的 defer close暴露 Dispatch 便于测试 filter 与 RouteFunctionswagger 响应模型不能是数组打 TAG 1.0.02016-12-22API 变更移除请求内容缓存相关代码删除SetCacheReadEntity(doCache bool)2016-11-26默认行为三连变默认路由改为 CurlyRouter原为 RouterJSR311不再缓存请求内容不再从 panic 中恢复2016-09-22修复 DefaultRequestContentType 特性2016-02-14决定响应 contenttype 时纳入 Accept 头 mediatype 的 quality 因子为 xml/json 实体访问器新增构造器早期形成期2012-11 2015日期变更记录changelog 原文要点2015-09-27WriteStatusAnd...重命名为WriteHeaderAnd...保持一致性2015-09-25修复 WriteHeader 之后修改 Header 失效的问题issue 2352015-09-14改变WriteHeader立即写出与WriteEntity不再写状态的行为语义支持自定义 EntityReaderWriters2015-08-06支持读取压缩后的请求内容请求/响应压缩器改用 sync.PoolParameter 增加 Description 用于 Swagger UI2015-03-20增加可配置日志2015-03-18未显式指定时Operation 从 Route 函数名推导2015-03-17暴露 Parameter 创建函数trace logger 改为接口修复 OPTIONSFilter可自定义 ServiceError 渲染JSR311 路由支持通配符Route 增加 Notes2014-11-27新增 per-response PrettyPrint#1672014-11-12新增ApiVersion(.)用于 Swagger UI 文档2014-11-10API 变更带 description tag 的 struct 字段会显示在 Swagger UI2014-10-31ReturnsError更名为Returns新增RouteBuilder.Do(aBuilder)便于复用修复 swagger 嵌套 struct按 code 排序 swagger 响应2014-10-23新增ReturnsError用于在 swagger 中记录 HTTP 码修复 CurlyRouter 的贪婪匹配问题CORS 增加 Access-Control-Max-Age新增可注入的 tracing 调试功能JSON 解析支持 64 位整型修复 swagger 空参数WebServiceUrl 对 swagger 变为可选修复 CORS 重复的 AccessControlAllowOrigincontainer 暴露 ServeMuxCORS 新增 AllowedDomains新增 ParameterNamed 用于细化文档2014-07-03CORS 可配置允许域列表2014-06-27ParameterNamed 提供 Parameter 定义及其数据SetCacheReadEntity控制请求 body 是否被缓存当时默认 true 以兼容2014-04-16暴露 Request 构造器便于测试2014-04-15修复v1.0.1 tag修复 Issue 111WriteErrorString2014-03-12路由路径参数支持通配符与正则表达式需配合 CurlyRouter2014-02-26Request 提供所命中 Route 的信息见方法SelectedRoutePath2014-02-17重命名参数常量go-lint 检查2014-01-10支持 CloseNotify2014-01-07Response 的 Write* 方法改为返回 error 或 nil新增 HTML Go template 示例CORS Allowed 头比较改为大小写不敏感2013-11-13Response 可感知已写出的字节数2013-10-29新增RecoverHandler(handler RecoverHandleFunction)定制 panic 恢复行为默认打日志并返回 stacktrace作者提示这可能是安全隐患因为暴露源码信息2013-10-04Response 可感知已写出的 HTTP 状态码Request 支持 attributesstring-interface 映射即 request 级变量2013-09-12API 变更Router 接口简化实现 CurlyRouter——一个不在路径中使用/允许正则的路由器2013-08-27修复若干已报告问题API 变更弃用 WriteError改用 WriteErrorString2013-08-08新增 Container 实现带独立 http.ServeMux 的 WebServices 集合支持一个程序多端点已有用法会注册到 DefaultContainerswagger 包扩展为每 container 一套 UIpanic 时打印短 stack traceResponse 新增 WriteErrorString。API 移除包变量 DoNotRecover 与 EnableContentEncoding 失效改用restful.DefaultContainer.DoNotRecover(true)/EnableContentEncoding(true)2013-08-05新增 OPTIONS 支持与 CORS 支持2013-07-06新增响应编码gzip 与 deflate/zlib支持默认关闭以保持向后兼容2013-06-19改进DoNotRecover 选项、request body 位置优化、改进 ReadEntity2013-06-03API 变更移除 Dispatcher 接口隐藏 PathExpressionreceiver 命名改为更地道的 Go 风格2013-06-02优化缓存路径的 RegExp 编译结果2013-05-22新增请求/响应 filter 函数支持2013-05-18API 变更允许更换默认 Http Request Dispatch 函数Swagger Webservice 移入 swagger 包2012-11-14初始提交阶段一框架骨架的成型2012-11 2013changelog 显示 go-restful 于 2012-11-14 完成初始提交半个月内即具备可用的核心结构。2013 年上半年密集补齐了后续所有版本都依赖的三大基础设施Filter 机制2013-05-22请求/响应 filter 是整个框架的拦截层后续 CORS 过滤器、OPTIONS 自动响应、panic 恢复、内容编码全部构建在这条链上。vendor 目录中对应 filter.go 与 filter_adapter.go后者正是 2013-05-18 允许更换默认 Dispatch 函数的落点——把任意 http.Handler 适配为 filter 的HttpMiddlewareHandlerToFilter能力。CurlyRouter2013-09-12changelog 原文称其为a Router that does not use|allow regular expressions in paths即把路径参数从正则表达式驱动改为{id}花括号 token 驱动并同步简化了 Router 接口。实现即 curly.go、curly_route.go接口定义在 router.go。同年 10-23 记录的修复贪婪 CurlyRouter说明早期版本存在静态段与动态段抢占的匹配缺陷。Container 抽象2013-08-08引入带独立http.ServeMux的 WebServices 集合支撑一个进程多个端点。这是本次架构上最大的一步包级开关DoNotRecover、EnableContentEncoding被移除改为restful.DefaultContainer.DoNotRecover(true)之类的实例方法。vendor 中的 web_service_container.go 与 container.go 即是这一设计的最终形态。同期还落地了内容编码2013-07-06gzip/deflate默认关闭对应 compress.go、compressor_cache.go、compressor_pools.go与 OPTIONS/CORS2013-08-05对应 options_filter.go、cors_filter.go。阶段二v2 时代的三次默认行为转折2014 20172014 年的改动以 API 增补为主ParameterNamed、Returns/ReturnsError、SelectedRoutePath、CloseNotify、PrettyPrint、ApiVersion 等多数服务于 Swagger 文档生成这一当时的主要场景。值得单独指出的是 2014-10-23 条目ReturnsError先加入、2014-10-31 又更名为Returns属于短期内两次 API 调整。2016-11-26 是全 changelog 信息量最大的一条三项默认行为同日变更默认路由从 RouterJSR311 换成CurlyRouter——与 jsr311.go 并存两套路由器同时保留至今不再缓存请求内容配套 2016-12-22 彻底移除SetCacheReadEntity默认不再从 panic 中恢复配合 2013-10-29 引入的RecoverHandler定制点把恢复策略交还给使用者。2017-01-30 完成了与 swagger 1.2 代码的切割swagger 相关代码移入独立的 go-restful-swagger12 包主库只保留 OpenAPI 声明能力配合 route.go 中Returns/Writes等文档元数据 API并打出 2.0.0 tag。此后 v2.8.0v2.11.x 主要是打磨QueryParameters()、json-iterator build tag、per-Route 内容编码、空 body 不返回 415v2.9.3#396、路径变量前后缀v2.11.0#414对应 path_expression.go 的正则支持、google 自定义动词v2.9.6#413对应 custom_verb.go。阶段三v3 模块时代与安全加固2019 2025v3.0.0 的两个要点修复必须使用 filter chain 中最终产生的 request/response以及正式接入 Go Modulesimport 路径加/v3后缀。这也是本仓库 go.mod 采用github.com/emicklei/go-restful/v3路径的原因。路径拼接策略的风波v3.10.x 的连续翻车与 v3.11.0 的收敛v3.10 系列是这份 changelog 中最罕见的版本状态标注案例值得完整还原v3.10.02022-10-11标注 BROKEN为了对齐标准路由行为tokenizer 不再 trimright 路径#511同时混入了 MIME_ZIP#512/#513与 query 参数获取方式变更#510v3.10.12022-11-19与 v3.10.22023-03-09均标注 DO NOT USE前者用path包重写路径拼接仍不完整后者引入MergePathStrategy提供回退手段但作者仍判定不可用v3.11.02023-08-19收敛恢复 ≤v3.9.0 的行为并保留包级变量TrimRightSlashEnabledREADME 明确其默认为 true作为改变斜杠匹配策略的开关。这条线索的工程启示在于跨 minor 版本的路径匹配行为变更可能悄悄改变路由命中结果升级 REST 框架类依赖时路径拼接与尾斜杠处理是必须回归测试的面。本仓库锁定 v3.13.0已处于该风波收敛之后的稳定线上。CORS 安全加固v3.8.0 的授权绕过修复v3.8.02022-06-06条目原文use exact matching of allowed domain entries, issue #489 (#493) — this changes fixes [security] Authorization Bypass Through User-Controlled Key by changing the behaviour of the AllowedDomains setting in the CORS filter. To support the previous behaviour, the CORS filter type now has a AllowedDomainFunc callback mechanism which is called when a simple domain match fails.这是本次历史中唯一明确冠以security的条目AllowedDomains 由宽松的域匹配改为精确匹配规避用户可控 key 导致的授权绕过同时新增AllowedDomainFunc回调简单匹配失败时再走自定义逻辑保证向后兼容。实现位于 vendor 中的 cors_filter.go。与之呼应的后续改进包括 v3.5.0 的 CORS 通配符检查#463以及 2014-01-07 更早的Allowed 头比较改为大小写不敏感。空请求体处理一个跨越十年的反复修复主题changelog 中至少有四处围绕空 body / 无 Content-Type 请求的修复v2.9.32017请求 body 为空时不再误返 415 Unsupported Media Type#396v3.8.0补测并修复无 body、无 Content-type 的 POST#492/#496v3.12.02024-03-11修复Improper handling of empty POST requests#543v3.12.22025-02-21正式允许 post/put/patch 携带空 payloadissue #580。这说明 REST 框架对合法但极简请求的容错是一个持续暴露、持续修补的边界若基于该框架构建服务空 body 的 PUT/PATCH 语义升级后才会完全放开。性能优化谱系按 changelog 可拼出一条清晰的路径匹配性能演进线2013-06-02缓存路径 RegExp 编译结果正则缓存自此成为默认能力README 提到可用SetPathTokenCacheEnabled、SetCustomVerbCacheEnabled关闭默认 truev2.9.2#395减少 per-request 方法中的内存分配2015-08-06请求/响应压缩器改用 sync.Pool对应 compressor_pools.gov3.13.02025-08-14本仓库锁定版本优化 CurlyRouter 路径匹配性能——这是 vendored 代码 curly.go / curly_route.go 中当前生效的匹配算法版本。序列化与 OpenAPI 文档能力的扩展自定义 JSON 处理链v2.6.1 引入JSONNewDecoderFuncv2.8.0 通过 build tag 支持 json-iteratorv3.11.1/v3.11.2 专门恢复自定义 JSON handler 函数#540v3.11.0 的 tokenizer 改动曾误伤该能力两个补丁版本 v3.11.3 的避免双 tag共同构成了快速回滚-重发的发版节奏。实体序列化基础在 entity_accessors.go2015-09-14 起支持注册自定义 EntityReaderWriters。OpenAPI 声明v2.6.0 统一 JSR311 路由与路径参数文档一致性v3.6.0 支持 vendor extensions#477v3.7.0 扩展 parameter 的 OpenAPI 映射#478v3.1.0 支持描述响应头#426并修复 examples#425。参数文档 API 位于 parameter.go。错误与响应语义v3.2.0 强制 405 响应携带 Allow 头#436并引入allowedMethodsWithoutContentType#424v3.3.0 让 406 响应体列出可用 representation#437错误渲染基础是 service_error.go。扩展点补齐v3.9.0 允许把任意 http.Handler 实现当 FilterFunction 使用#504v3.12.0 为 response.go 增加 Flush 方法#529/#538服务于流式/分块响应场景。在 Tekton Pipeline 仓库中验证这份变更史如果你想把 changelog 条目与 vendored 源码一一对照可直接浏览 vendor/github.com/emicklei/go-restful/v3 目录其文件布局与功能条目高度对应路由层router.goRouter 接口、curly.go默认 CurlyRouter、jsr311.go、path_expression.go、custom_verb.gov2.10.0 的自定义动词服务层web_service.goWebService 与 Route 注册、web_service_container.goContainer、options_filter.gov3.4.0 的 OPTIONS 支持请求/响应与编码request.go、response.go、entity_accessors.go、compress.go 及压缩器池横切能力cors_filter.go、mime.go、logger.go2015-03-20 的可配置日志与 log/log.go。需要注意的适用前提该目录是 vendor 快照内容对应 go.sum 中固定的 v3.13.0 哈希不随上游 master 分支变化Tekton 侧不直接调用这些 API其价值主要体现在依赖审计、安全通告排查例如核对 v3.8.0 CORS 修复是否已包含在本快照中以及理解 k8s 生态传递依赖的行为边界。总结CHANGES.md 虽只有百余行却完整记录了一个 Go REST 框架十三年间的三条主线路由算法JSR311 → CurlyRouter 默认化 → v3.10.x 路径拼接风波 → v3.13.0 匹配性能优化、安全与合规CORS 精确匹配与 AllowedDomainFunc 回调、405 必须带 Allow 头、序列化与文档扩展自定义 JSON handler、OpenAPI vendor extensions、per-Route 内容编码。对维护 Tekton Pipeline 这类以 Kubernetes 生态依赖为主的仓库而言读懂依赖的 changelog 是升级决策前的必要功课——尤其是本仓库锁定的 v3.13.0 正处于 CurlyRouter 性能优化的最新版本而 v3.10.0~v3.10.2 被作者亲自标注 BROKEN / DO NOT USE 的先例正是跨版本路径匹配行为不可默认兼容的最佳注脚。赞分享云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载相关推荐go-restful v3 演进全解析从 CHANGES.md 与源码读懂 REST 框架的十年设计变迁go restful v3 演进全解析从 CHANGES.md 与源码读懂 REST 框架的十年设计变迁 本文以当前仓库中 vendored 的 go res云原生CLI应用安全RetroArch 版本演进深度解析从 CHANGES.md 看 libretro 前端的十年技术积累RetroArch 版本演进深度解析从 CHANGES.md 看 libretro 前端的十年技术积累 导读 CHANGES.md https://link.游戏开发跨平台音视频从 CHANGES.md 看 gax-go v2 演进Sliver 仓库中 Google API 调用基础设施的完整解析从 CHANGES.md 看 gax go v2 演进Sliver 仓库中 Google API 调用基础设施的完整解析 导读 本文以 Sliver 仓库网络安全上一篇ParquetViewer突破Windows平台数据查看限制让Parquet文件处理效率提升10倍下一篇Python CAN工具(cantools)实战指南从问题到解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考