jeecgboot/jimureport

项目介绍

积木报表（JimuReport）是一套运行在 Spring Boot 应用中的 Java 报表与 BI 套件，包含三个模块：JimuReport 负责传统复杂报表与打印，JimuBI 负责数据大屏和仪表盘，JimuChatBI 提供对话式数据分析。报表设计器在浏览器中以类 Excel 的单元格网格完成设计，支持分组、交叉、主子、多 Sheet 等企业报表结构，也支持数据填报回写数据库、套打发票与证照、条件查询和二维码条码。

数据源覆盖 MySQL、Oracle、PostgreSQL、ClickHouse、Doris、Elasticsearch 以及达梦、人大金仓等约 30 种。AI 功能是可选项，通过任意兼容 OpenAI Chat Completions 的服务商实现，可以根据自然语言提示或上传截图生成报表、大屏、仪表盘和 ChatBI 视图。

快速使用

本项目以 Maven 依赖方式集成，不是独立可执行程序。示例应用要求 JDK 17+、MySQL 5.7+，Redis 可选，并需手工执行 db/jimureport.mysql5.7.create.sql 初始化数据库 环境要求。完整配置步骤见官方快速集成文档 快速集成。

1. 在 pom.xml 中按 Spring Boot 版本引入 starter：Spring Boot 3 使用 jimureport-spring-boot3-starter 2.5.6.1，Spring Boot 4 使用 jimureport-spring-boot4-starter，Spring Boot 2 使用 jimureport-spring-boot-starter 但不支持 AI 助手 依赖示例。
2. 引入 jimubi-spring-boot3-starter（或对应版本）启用大屏和仪表盘 JimuBI 依赖。
3. 如需对话式分析，再引入 jimuchatbi-spring-boot3-starter 1.2.0 ChatBI 依赖。
4. 执行建库脚本并调整 application-dev.yml 中的数据源配置。

启用 AI 助手需在 application.yml 中加入以下配置，并使用自己的密钥：

jeecg:
  jmreport:
    ai:
      base-url: https://api.deepseek.com
      api-key: sk-xxxxxxxxxxxxxxxxxxxx
      model: deepseek-v4-pro
      temperature: 0
      autoTableEnabled: false

配置后报表设计器中会出现 AI 入口。可参考示例工程启动集成版；默认账号为 admin，未配置密码时每次启动随机生成并打印在启动日志中，可通过 JIMU_ADMIN_PASSWORD 或 spring.security.user.password 固定 默认密码说明。如果只想先体验设计器，可使用在线演示。

使用约束

• Spring Boot 4 版本要求 JDK 17+，Spring Boot 2 仅需 JDK 8+ 但缺少 AI 助手 集成说明。
• 从 2.5.4 起，JimuReport、JimuBI、JimuChatBI 的签名与加密方案同源，三者必须同步升级，版本不匹配会出现验签失败或数据源连不上 版本兼容。
• AI 功能依赖外部 OpenAI 兼容接口和自备 API Key；autoTableEnabled 打开后 AI 可在指定数据源上执行 DDL/DML，生产环境应保持关闭 AI 配置。
• 仓库声明采用 GPL-3.0 及附加条款，若要去掉“Powered by 积木报表”等版权标识并用于商业用途，需要购买商业授权 授权协议。
• README 还提供了一条 Windows PowerShell irm ... | iex 和 macOS/Linux curl ... | bash 命令，用于安装 Claude Code 与项目技能。脚本位于第三方域名，仓库内没有脚本内容说明，执行前应自行检查。

HotRepo 点评

2026-11-04 的快照显示仓库有 8,563 个 Star 和 1,893 个 Fork，当日 Java 日榜新增 3 个 Star，最高位列第 16。目前只有这一条站内记录，只能说明当天的榜单表现，不足以判断趋势。README 近期把重点放在 AI 生成和 ChatBI 上，但依赖结构说明它仍是一套成熟的 Spring Boot 报表组件。对需要内嵌报表设计器、并希望选择性接入 AI 生成的 Java 团队，这类项目比较合适；如果只想独立使用报表工具，仍需准备宿主应用和数据库。