web项目_南昌壹佳企网络通信有限公司

GoHTTPhandler中panic默认导致500且响应不可控，须用recover中间件拦截并统一转为结构化错误响应；应定义带状态码的AppError类型、统一响应包装器Respond，并区分HTTP状态码与业务code。

GoWeb项目需用swag或oapi-codegen生成OpenAPI文档：swag通过注释驱动，要求结构体带jsontag、执行swaginit并配置参数；oapi-codegen适用于契约优先开发，反向生成代码；文档更新须纳入CI自动校验。

main.go应放在cmd/目录下，如cmd/myapp/main.go，仅负责初始化并启动服务；避免根目录混乱、提升可维护性与多二进制支持。

最合理是将校验逻辑提前到中间件或封装的ParseAndValidate函数中，使handler专注业务；需统一错误格式、严格状态码语义、避免重复读取r.Body，并用go-playground/validator结合自定义配置与翻译实现精准字段级校验。

接口响应必须统一为JSON格式，顶层字段固定为code、msg、data；code为整数状态码，msg为提示信息，data为业务数据；传参须明确路径（JSONbody或form），时间字段严格使用RFC3339格式。

推荐用page+size，后端转为offset+limit；可校验边界防越界，避免前端传过大offset导致全表扫描；大数据量时应改用游标分页（如WHEREcreated_at

静态资源应统一放在./static目录，开发期用http.Dir("./static")，生产期优先使用embed.FS嵌入；CSS/JS中需用绝对路径（如/static/logo.png）或构建工具处理。

前端防重提交不能替代后端幂等，因网络超时、刷新、脚本或恶意请求可绕过；后端须通过唯一索引插入、乐观锁+状态机、Redis短时去重（key含业务维度）等手段保障幂等。

GoHTTP中间件本质是函数套函数，标准签名返回http.Handler或接受http.HandlerFunc；需注意类型匹配、顺序嵌套、context安全传递、连接级事件不可控及响应后必须return等核心要点。