首页
/ Boulder项目中的URL结构调整:账户ID嵌入授权与挑战路径

Boulder项目中的URL结构调整:账户ID嵌入授权与挑战路径

2025-06-07 12:11:59作者:宣利权Counsellor

在Boulder项目的开发过程中,团队针对数据库水平分片需求进行了URL结构的重大调整。本文将详细解析这一技术改进的背景、设计思路及实现方案。

背景与挑战

随着业务规模扩大,Boulder项目计划对数据库进行水平分片处理。根据技术方案,数据分片将基于分片键进行路由,而分片键很可能包含订单、授权和挑战对象所属账户的注册ID。然而,当时系统对外暴露的API URL结构中,授权和挑战对象的路径并未包含所属账户的注册ID,这导致查询时无法确定应在哪个分片查找目标对象。

解决方案设计

项目组提出了两种URL结构调整方案:

方案一:RESTful风格路径

该方案采用层次分明的资源定位方式:

  • 账户路径:/accts/{RegID}
  • 订单路径:/accts/{RegID}/orders/{OrderID}
  • 授权路径:/accts/{RegID}/authzs/{AuthzID}
  • 挑战路径:/accts/{RegID}/authzs/{AuthzID}/challs/{ChallStringID}

方案二:最小改动路径

该方案在保持原有结构基础上进行扩展:

  • 账户路径保持不变:/acme/acct/{RegID}
  • 订单路径扩展:/acme/order/{RegID}/{OrderID}
  • 授权路径调整:/acme/authz/{RegID}/{AuthzID}
  • 挑战路径调整:/acme/chall/{RegID}/{AuthzID}/{ChallStringID}

经过评估,团队最终选择了方案一,因其具有更清晰的资源层次关系,虽然改动较大但长期维护性更好。

实施与过渡

实施过程分为几个关键阶段:

  1. 新URL结构部署:在release-2024-11-19版本中完成了新URL结构的部署
  2. 旧URL淘汰:观察到旧式URL的最后访问时间,确保所有旧式引用最终过期
  3. 清理工作:在release-2024-12-16版本后完成相关清理工作

技术价值

这一改进带来了多重技术优势:

  1. 分片支持:明确的分片键信息使水平分片成为可能
  2. 资源归属清晰:URL本身即表明资源所属关系
  3. API一致性:统一了不同资源的定位方式
  4. 可扩展性:为未来可能的扩展预留了结构空间

总结

Boulder项目通过将账户ID嵌入授权与挑战路径的结构调整,不仅解决了数据库分片的技术需求,还提升了API设计的整体质量。这种前瞻性的改进体现了项目团队对系统架构演进的深入思考,为后续的功能扩展和性能优化奠定了坚实基础。

登录后查看全文
热门项目推荐
相关项目推荐