yii统计报表核心是控节奏、分层次、避陷阱：优先预计算+聚合库替代实时大表join；导出异步化并模板化字段映射；查询接口集成缓存依赖与降级开关；权限控制下沉至dao层及数据库视图。
Yii做数据统计后台报表查询，核心不是堆功能，而是控节奏、分层次、避陷阱。重点在于让“查得准”和“查得快”不打架，同时保证后续可维护。
优先走预计算+聚合库，别硬扛实时大表
统计类报表最常见误区是直接在订单表、日志表上写复杂JOIN和GROUP BY。用户点一次，数据库扫几百万行，响应慢还拖垮主库。正确做法是：
- 把高频统计维度（如按天/按地区/按状态的订单金额、用户数）提前算好，存到专用统计库（如前面提到的
dbStats）里，用定时任务或消息队列触发更新 - 前端查询只对接这张宽表，SQL简单清晰，加索引后毫秒级返回
- 需要明细下钻时，再跳转到业务库查原始记录，用forceMaster确保看到最新数据
导出逻辑必须和查询解耦，且支持异步
Excel导出本质是IO密集型操作，和Web请求生命周期冲突。用户点“导出10万条”，不能卡住整个HTTP响应。
- 点击后立即返回任务ID，前端轮询状态；后端用yii2-queue或独立worker异步执行导出，生成文件存OSS或本地共享目录
- 导出不用PHPExcel（已停止维护），改用PHP_XLSXWriter（轻量、内存友好、支持大数据流式写入）
- 模板化字段映射：配置一个数组，定义“数据库字段 → Excel列名 → 格式（日期/货币/百分比）”，避免每张报表重复写格式逻辑
查询接口要带“降级开关”和缓存依赖
统计接口容易成为性能瓶颈，但又不能简单关掉。关键是在架构层留退路：
- 用
DbDependency绑定缓存，比如“只要统计表stats_daily有更新，所有相关报表缓存自动失效” - 在控制器中判断是否开启强制刷新（如加
?force=1参数），绕过缓存直连主库，方便运维排查 - 对非核心维度（如“按用户手机尾号分布”）默认返回缓存结果，标注“数据截至昨日”，避免为低价值查询消耗资源
权限和数据隔离必须下沉到DAO层
统计后台常有多租户或角色数据范围限制（如区域经理只能看本省）。如果只在Controller里if ($user->region !== 'shanghai') die()，极易漏掉API、导出、定时任务等入口。
- 在ActiveRecord的
find()方法里统一注入WHERE条件，例如重写find()返回自定义Query类，自动追加andWhere(['region' => Yii::$app->user->identity->region]) - 统计SQL尽量用视图或物化视图封装，权限控制直接下推到数据库层（如达梦/人大金仓支持行级策略）
- 敏感指标（如GMV、利润率）单独建视图，仅授权给财务角色，避免代码里硬编码字段过滤
