直接拼接SQL字符串生成报表会出问题，因为易引发SQL注入、字段名被恶意篡改、排序字段绕过白名单校验等风险；例如传入order_by=created_at; DROP TABLE users;若未严格过滤，可能执行危险操作。
为什么直接拼接 SQL 字符串生成报表会出问题
Gin 本身不处理 SQL 构建，但很多开发者在写动态报表 API 时，习惯用 fmt.Sprintf 或字符串拼接组装查询语句。这会导致 SQL 注入、字段名被恶意篡改、排序字段绕过白名单校验等问题。比如传入 order_by=created_at; DROP TABLE users;，若没做严格过滤，就可能执行危险操作。
- 报表字段（
select_fields）必须限定在预定义的白名单内，不能直接反射结构体字段名 - 排序字段（
order_by）需校验是否属于合法列，且只允许单字段 +ASC/DESC后缀 - 条件参数（如
status=active®ion=us）应统一走sqlx.Named或database/sql的占位符绑定，避免拼接 - 时间范围类参数（
start_time/end_time）务必做格式校验和时区归一化，否则跨时区查询结果错乱
如何用 Gin 中间件统一校验多维参数
报表接口常带十几个可选参数（分组维度、指标聚合方式、时间粒度、导出格式等），全在 handler 里 if-else 容易失控。建议用中间件提前解析并注入上下文：
- 定义一个
ReportRequest结构体，嵌入Binding标签做基础校验（如time.Time字段用binding:"required"） - 在中间件中调用
c.ShouldBindQuery(&req)，失败则直接返回400并附带具体错误字段 - 对非标准字段（如自定义分组字段列表
group_by=["user_id","product_type"]），用json.Unmarshal单独解析，并校验每个值是否在allowedGroupByFields白名单中 - 将清洗后的参数存入
c.Set("report_req", &req)，后续 handler 直接取用，避免重复解析
聚合逻辑该放在数据库还是 Go 层
简单计数、求和、平均值这类操作，一律交给数据库（PostgreSQL/MySQL 聚合函数）。Go 层做聚合只适用于：需要复杂条件判断（如“近 7 天活跃用户中，iOS 占比”）、或数据量小（<10 万行）且需对接多个异构数据源。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 使用
GROUP BY时注意 MySQL 5.7 默认开启ONLY_FULL_GROUP_BY，SELECT 列必须在 GROUP BY 中或为聚合函数结果，否则报错Expression #1 of SELECT list is not in GROUP BY clause - 若需支持 “按日/周/月 分组”，不要在 Go 层用
time.Truncate处理时间戳再 group，而应交由数据库函数（如 PostgreSQL 的date_trunc('day', created_at)），确保时区一致 - 导出 CSV 时，聚合后数据量仍较大（>10 万行），别一次性
json.Marshal再转 CSV，改用csv.Writer流式写入响应体，防止内存暴涨
Gin 路由怎么设计才支持灵活维度切换
别用固定路径如 /api/v1/report/user-active，而是统一走 /api/v1/report，靠 query 参数驱动维度组合：
立即学习“go语言免费学习笔记（深入）”；
- 允许通过
type=user_active指定报表模板，后端查配置表获取该类型默认维度、指标、过滤规则 - 支持覆盖参数，例如
type=user_active&group_by=["region","device"]&metrics=["count","avg_duration"] - 对高频组合（如“按天统计订单金额”），可在配置表中标记
is_cached=true，然后用redis.HGetAll查缓存，命中则跳过 DB 查询 - 注意 URL 长度限制，Chrome 对 URL 最大长度约 2MB，但实际建议单个请求 query string 不超过 8KB；超长参数应改用
POST /api/v1/report+ JSON body
字段名、聚合函数名、时间单位这些关键词，稍不留神就会被前端随意传入导致报错或越权。真正难的不是写出来，是让每个维度参数都有明确边界和 fallback 行为。
