EzCloud自定义BI报表模块源码解析：动态SQL查询、可视化图表与多租户数据统计实现

前言

企业级微服务系统开发中，数据报表与可视化统计是业务落地的核心刚需模块。传统开发模式下，每新增一项统计报表都需要单独编写SQL、开发接口、适配前端图表，重复性代码量大、迭代效率低，且多租户场景下极易出现数据统计越权、跨租户数据汇总错乱问题。

EzCloud 独立拆分自定义BI报表模块，完全插件化解耦设计，底层封装动态SQL解析、通用数据查询、图表渲染、租户数据过滤能力，支持后台自主配置报表、无需改动代码即可生成业务统计图表，是低代码系统中数据可视化能力的核心实现。

1、报表模块工程分层结构

报表模块内部职责分层清晰，彻底解耦查询、解析、渲染逻辑：

report-config 报表配置层：存储用户自定义报表、查询条件、数据源、图表类型配置
report-query 动态查询层：封装动态SQL拼接、参数解析、租户自动过滤、数据分页统计
report-render 图表渲染层：统一适配柱状图、折线图、饼图、数据表格、大屏指标渲染

所有业务报表数据统一由该模块承载，ERP进销存、CRM客户、OA审批、维保工单的统计数据，均通过统一接口汇总渲染，无需各业务模块单独开发统计接口。

2、核心源码：动态报表自动查询与租户隔离实现

模块核心亮点为无代码动态报表生成，通过后台配置SQL模板，自动拼接参数与租户过滤条件，实现一键生成统计数据，核心实现如下：

复制代码

@Service
public class ReportQueryServiceImpl implements ReportQueryService {

    @Autowired
    private ReportConfigMapper reportConfigMapper;
    @Autowired
    private DynamicSqlUtil dynamicSqlUtil;

    @Override
    public Map<String, Object> getReportData(Long reportId, Map<String, Object> param, Long tenantId) {
        // 1、查询当前报表自定义配置信息
        ReportConfigDO config = reportConfigMapper.selectById(reportId);
        if (Objects.isNull(config)) {
            throw new BusinessException("报表配置不存在");
        }
        // 2、动态解析SQL模板，替换前台传入参数
        String sql = dynamicSqlUtil.parseSql(config.getSqlTemplate(), param);
        // 3、自动拼接多租户过滤条件，防止数据越权
        String tenantSql = dynamicSqlUtil.appendTenantFilter(sql, tenantId);
        // 4、执行动态查询，返回结构化报表数据
        List<Map<String, Object>> dataList = dynamicSqlUtil.executeQuery(tenantSql);
        // 5、封装图表、表格统一返回格式
        return ResultUtil.buildReportData(dataList, config.getChartType());
    }
}

代码技术设计亮点

支持自定义SQL模板配置，业务人员后台配置即可生成新报表，无需后端迭代开发；
底层自动拼接租户过滤条件，从根源杜绝多租户报表数据穿透、统计错乱问题；
统一动态SQL解析工具类，防止SQL注入，保障自定义报表的安全性；
适配多种图表类型，一套查询逻辑支撑表格、折线图、柱状图、饼图数据渲染。

3、模块核心技术能力

（1）零代码报表新增能力

区别于传统硬编码报表，本模块支持后台自主配置数据源、查询参数、图表样式、统计维度，快速生成销售统计、库存统计、客户统计、售后统计等各类业务报表。

（2）全局数据权限联动

报表查询自动适配账号数据权限，员工仅可查看个人数据、部门管理员查看部门数据、超管查看全量数据，权限体系与系统完全打通。

（3）可视化数据大屏适配

支持关键指标卡片、趋势图、占比图、排名榜单等大屏组件数据输出，可快速搭建企业数字化数据看板。https://gitee.com/tan-tianming/ez-cloud.git

4、二次开发拓展特性

所有业务模块统计数据统一收口，无需重复开发统计接口，极大减少冗余代码；
支持报表导出、数据筛选、时间维度筛选、自定义排序等通用能力；
独立可插拔模块，无需可视化报表场景可直接移除，不影响核心业务运行；
动态SQL做安全预处理，规避注入风险，适配企业生产环境使用标准。

总结

EzCloud自定义BI报表模块，解决了传统企业系统报表开发繁琐、迭代缓慢、数据权限难控制的技术痛点，以动态SQL解析、租户隔离、零代码配置为核心能力，实现了业务报表快速搭建与数据可视化，是微服务低代码平台中极具参考价值的数据统计方案。