1. How I write HTTP services in Go after 13 years (grafana.com)
编写Go语言HTTP服务的实践总结（基于13年经验）
本文基于作者多年使用Go编写HTTP服务的实践，总结了一套注重可维护性、可测试性和清晰结构的方法。核心内容如下：
核心架构模式
NewServer构造函数：为服务创建一个集中的构造函数，该函数接收所有依赖项（如logger、数据库存储）作为参数，并返回一个http.Handler。这确保了依赖项的显式传递和类型安全。- 路由集中管理：建议在
routes.go文件中映射所有API路由。这为查看服务的完整API表面提供了一个单一的入口点。 main与run分离：main函数应保持极简，仅调用run函数。run函数接收操作系统基础对象（如参数、环境变量获取函数、标准输入/输出）作为参数，并返回错误。这极大地简化了测试，因为测试代码可以调用run来模拟完整程序的执行。
优化与技巧
- 优雅关停：通过
context.Context贯穿整个调用链来处理程序关停信号（如Ctrl+C）。在run函数中捕获信号并取消上下文，所有依赖项应尊重此上下文以便有序退出。 - 延迟初始化：对于耗时的初始化工作（如解析模板），可以使用
sync.Once将初始化推迟到处理程序首次被调用时，从而加快服务启动速度。 - 统一编解码：使用辅助函数（如
encode和decode）来统一处理请求体的解码和响应体的编码。可以结合泛型来增加灵活性。 - 数据验证：通过定义一个
Validator接口（包含Valid方法），可以在解码数据时进行统一的验证，保持代码简洁。
中间件与处理器设计
- 中间件适配器模式：中间件是接受一个
http.Handler并返回一个新http.Handler的函数。建议在routes.go中直接应用中间件，清晰展示每个路由的中间件链。 - 处理器工厂函数：处理器函数（handler）不直接实现
http.Handler，而是返回它。这允许在函数内部进行一次性设置工作（初始化），并为处理程序提供闭包环境。处理器特定的请求和响应类型可以定义在函数内部，保持全局空间整洁。
测试策略
- 端到端测试优先：作者倾向于通过调用
run函数来执行整个程序进行测试，模拟生产环境。这能测试到所有层（包括路由、中间件、处理程序和真实依赖），并减少测试间的重复。 - 测试自包含：每个测试通过
run获得独立的程序实例，可以传递不同的参数和模拟的环境变量。使用context.WithCancel并在测试结束时取消上下文以实现优雅关停。 - 等待服务就绪：在测试中，可以通过轮询
/healthz等健康检查端点来等待服务完全启动，而不是依赖复杂的信号机制。 - 测试可读性：测试应讲述一个清晰的故事。例如，在测试中定义与测试用例最相关的请求类型，只包含必要字段，使测试意图一目了然。
总结
这套方法旨在创建易于阅读、扩展和维护的HTTP服务代码。它强调依赖的显式传递、关注点分离、清晰的代码组织以及强大的端到端测试。虽然在实际项目中可能需要根据团队或技术栈（如gRPC）进行调整，但其核心思想（如可测试性、清晰结构）具有普适价值。