Skip to main content

2025 社区月报 (09.01 - 09.30)

· 阅读需约 4 分钟

最近,我们新增并优化了一些功能,如 request-id 插件支持 KSUID 算法、ai-proxy-multi 插件针对 429/5xx 状态码增加自动重试与节点降级等。有关更多细节,请阅读本期月报。

导语

Apache APISIX 项目始终秉承着开源社区协作的精神,自问世起便崭露头角,如今已经成为全球最活跃的开源 API 网关项目之一。正如谚语所言,“众人拾柴火焰高”,这一辉煌成就,得益于整个社区伙伴的协同努力。

从 2025.09.01 至 2025.09.30,有 17 名开发者提交了 76 个 commits,为 Apache APISIX 做出了重要贡献。感谢这些伙伴们对 Apache APISIX 的无私支持!正是因为你们的付出,才能让 Apache APISIX 项目不断改进、提升和壮大。

贡献者统计

贡献者名单
Click to Preview

新晋贡献者
Click to Preview

近期亮点功能

1. Admin API 在写入时不再自动填充默认值

相关 PR:https://github.com/apache/apisix/pull/12603

贡献者:SkyeYoung

Admin API 不再用默认值覆盖用户数据。写入 etcd 时保持原样,默认值只在 APISIX 内部补齐,既避免用户配置被悄悄改动,也保证 Ingress Controller 的 ADC 比对逻辑与旧版本兼容。

2. request-id 插件支持 KSUID 算法

相关 PR:https://github.com/apache/apisix/pull/12573

贡献者:Crazy-xyr

本 PR 将原有的 request-id 生成方式替换为 KSUID(可排序唯一标识符)算法。KSUID 始终为 27 位字符,采用 base62 编码,确保其可用于 URL 场景。其核心优势在于支持字典序排序,即使作为字符串处理也能保持时间顺序。该算法还包含 128 位随机数,相比标准 UUID 具有更强的防冲突能力。

3. ai-proxy-multi 插件针对 429/5xx 状态码增加自动重试与节点降级

相关 PR:https://github.com/apache/apisix/pull/12571

贡献者:Revolyssup

ai-proxy-multi 插件现对 429/5xx 错误自动重试,并依次切换到下一个健康模型节点,直到请求成功,减少客户端感知到的失败。

4. ai-proxy 插件的访问日志与 Prometheus 指标中新增延迟和用量

相关 PR:https://github.com/apache/apisix/pull/12518

贡献者:Revolyssup

本 PR 在访问日志中为 ai-proxy 插件补充了延迟和 token 信息,方便排障;同时新增 AI 相关请求的 Prometheus 指标,并追加两个标签:request_type 用于区分普通请求与 AI 请求;llm_model 用于记录转发给上游 LLM 服务的模型名称。

5. 新增上下文变量 request_llm_model 在日志中保留客户端原始 LLM 模型

相关 PR:https://github.com/apache/apisix/pull/12554

贡献者:bzp2010

用户在记录 AI 代理请求时,需要保存未经网关修改的客户端原始 LLM 模型,因此新增上下文变量 request_llm_model 来存储该值。

结语

Apache APISIX 的项目官网和 Github 上的 Issues 上已经积累了比较丰富的文档教程和使用经验,如果您遇到问题可以翻阅文档,用关键词在 Issues 中搜索,也可以参与 Issues 上的讨论,提出自己的想法和实践经验。