最近,我们新增并优化了一些功能,如
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 项目不断改进、提升和壮大。
贡献者统计


近期亮点功能
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 上的讨论,提出自己的想法和实践经验。