参考架构是什么
参考架构为同类系统提供已验证的结构模板与组件清单，包含分层结构、集成方式以及安全、可观测、部署等非功能要求。新项目从中裁剪起步，可以减少重复设计，也能避免漏掉合规与运维必备项。
基本要素
| 包含内容 | 分层结构、组件选型、集成方式、非功能要求与交付配套 |
|---|---|
| 使用者 | 新项目设计者、架构评审者、外部合作与外包团队 |
| 维护方 | 架构组维护，沉淀项目经验后定期更新 |
| 使用原则 | 按场景裁剪，不匹配时说明理由而非硬塞 |
典型使用场景
- 新服务立项：从模板起步，快速形成完整设计
- 外包交付：用参考架构约束交付物的结构与非功能要求
- 架构评审：用统一清单检查是否遗漏安全与可观测
- 多团队并行开发：以同一模板保证接口与治理方式一致
- 项目复盘后回填：把新踩到的坑补充进模板
Web 服务参考架构示例
Web 服务参考架构示例
接入层：网关负责 TLS 终止、限流、鉴权与路由
应用层：无状态服务 + 配置中心，会话外置
数据层：主从数据库 + 缓存 + 对象存储
非功能：日志、指标、链路追踪三类可观测能力齐备
配套：密钥管理、发布回滚模板、容量与告警基线
# 每层注明可裁剪项与不可裁剪项，避免评审争议包含项与裁剪要点
| 层次 | 模板内容 | 裁剪要点 |
|---|---|---|
| 接入层 | 网关、限流、鉴权 | 内部服务可简化接入 |
| 应用层 | 无状态设计、配置外置 | 状态服务需额外说明 |
| 数据层 | 存储选型、备份策略 | 按数据等级调整加密 |
| 配套 | 日志指标追踪、密钥管理 | 不可裁剪，属底线要求 |
参考架构需要保鲜：长期不更新时，项目照抄后仍要推翻重来，模板反而成为负担。
维护建议
- 每季度结合项目复盘更新一次模板内容
- 标注版本与修订原因，便于项目组追溯差异