1. 项目概述
ruoyi-vue-pro作为一款基于Spring Boot和Vue.js的前后端分离快速开发框架,其报表模块提供了强大的数据可视化能力。在实际项目中,数据大屏和报表功能是业务系统的重要组成部分,能够直观展示关键业务指标和数据分析结果。本文将详细介绍如何在ruoyi-vue-pro中启用报表设计器及积木报表模块,并分享相关的SQL脚本和配置细节。
作为一名长期使用该框架的开发者,我发现很多团队在初次集成报表模块时都会遇到各种配置问题。通过本文,我将分享从模块启用到数据库配置的完整流程,以及在实际项目中积累的优化经验。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 报表模块启用配置
2.1 启用yudao-module-report模块
ruoyi-vue-pro采用模块化设计,报表功能默认是未启用的状态。要启用报表模块,需要修改项目根目录下的pom.xml文件:
- 打开
ruoyi-vue-pro/pom.xml文件 - 在
<modules>节点中找到被注释的yudao-module-report - 移除该模块的注释标记
实际操作后的配置片段应如下所示:
xml复制<modules>
<!-- 其他模块... -->
<module>yudao-module-report</module>
<!-- 其他模块... -->
</modules>
注意:在大型项目中,建议使用IDE的Maven插件刷新项目依赖,确保模块变更生效。我在实际项目中遇到过因缓存导致模块未正确加载的情况,简单的clean install操作就能解决。
2.2 添加report-biz依赖
仅启用模块还不够,还需要在服务端主模块中添加业务依赖:
- 打开
ruoyi-vue-pro/yudao-server/pom.xml文件 - 在
<dependencies>节点中添加或取消以下依赖的注释:
xml复制<dependency>
<groupId>cn.iocoder.boot</groupId>
<artifactId>yudao-module-report-biz</artifactId>
<version>${revision}</version>
</dependency>
这个依赖提供了报表模块的核心业务逻辑实现。根据我的经验,在多模块项目中,明确模块间的依赖关系非常重要。如果遇到类找不到的问题,首先检查这个依赖是否配置正确。
3. 数据库表结构初始化
报表功能需要依赖特定的数据库表结构。下面我将详细介绍两种主要报表类型所需的表结构。
3.1 数据大屏(GoView)相关表
GoView是ruoyi-vue-pro集成的数据大屏解决方案,需要以下表
