01Core pain point and demand
AWS API Gateway 会把查询参数中经过 URL 编码的分号（%3B）解码为字面分号，随后 Go 标准库 url.ParseQuery() 会直接报错 invalid semicolon separator in query，Gin 框架的 GetQuery 因此返回空值，OData 风格的过滤表达式（如 $filter=name eq 'a';age gt 18）解析彻底失败。开发者往往在本地环境无法复现，排查耗时且难以定位根因，最终只能改写查询语法或绕过 API Gateway。
02Product solution
提供一套面向 Go/Gin 的查询参数兼容中间件与诊断工具：1）中间件在请求进入 Gin 前对原始 RawQuery 做分号安全转义（将裸分号重新编码为 %3B 或替换为受控分隔符），再交给 url.ParseQuery；2）内置 OData 过滤表达式解析器，兼容分号分隔的多条件；3）提供 API Gateway 配置检查清单与 CloudFormation/Terraform 模板，避免网关层提前解码；4）附带可复现的测试用例与一键诊断 CLI，输入请求 URL 即可定位是网关层还是应用层问题。
03Monetization and business model
采用开源核心 + 商业增值模式：中间件与诊断 CLI 开源引流；付费提供企业版（OData 解析增强、审计日志、SLA 支持）、托管诊断服务（上传请求样本自动分析网关与应用层配置）、以及面向团队的 API Gateway 配置审查与迁移咨询。可通过 Go 社区、GitHub、技术博客和 AWS Marketplace 获客。
04Action steps
- 1复现问题：搭建最小 AWS API Gateway + Go/Gin 示例，确认 %3B 被解码为裸分号后 url.ParseQuery 报错、GetQuery 返回空值。
- 2开发 Gin 中间件：在路由前安全处理 RawQuery 中的裸分号，并提供可配置的兼容模式与错误提示。
- 3实现 OData 过滤表达式解析器，支持分号分隔多条件，并编写完整单元测试与回归用例。
- 4编写诊断 CLI：输入完整请求 URL 与网关配置，自动判断问题出在网关解码层还是应用解析层。
- 5产出 API Gateway 配置最佳实践文档及 CloudFormation/Terraform 模板，发布到 GitHub 与技术博客引流。
- 6在 Go/Gin 社区、Stack Overflow、Reddit 相关板块推广，收集早期用户反馈并迭代。
- 7上线企业版订阅与咨询服务的定价页，接入 AWS Marketplace 与支付渠道，启动商业化。
05Risk notice
痛点相对垂直、搜索量有限（约 1200/月），市场规模天花板较低；AWS 或 Gin 后续版本可能直接修复该行为，导致需求消失；开源替代方案易被复制，付费转化率不确定；需持续跟进 API Gateway 解码策略变化，维护成本存在。