【亲测免费】 AJ-Report 开源项目常见问题解决方案

一、项目基础介绍

AJ-Report 是一个完全开源的可视化设计工具，主要用于大屏数据的展示。它支持拖拽编辑，用户可以通过简单的三步快速完成大屏设计：配置数据源、写 SQL 配置数据集、拖拽生成大屏。该项目让管理层随时随地掌控业务动态，确保每个决策都有数据支撑。AJ-Report 支持多种数据源，包括 MySQL、Elasticsearch、Kudu 等，并内置了超过 30 种大屏组件/图表。主要使用的编程语言包括 Java（后端）、Vue（前端）。

二、新手常见问题及解决步骤

问题一：如何运行和部署 AJ-Report 项目？

解决步骤：

1. 确保本地安装了 JDK 1.8+ 和 Node.js。
2. 克隆项目到本地：

   git clone https://github.com/anji-plus/report.git
   

3. 进入项目目录，安装前端依赖：

   cd report/report-ui
   npm install
   

4. 启动前端开发环境：

   npm run dev
   

5. 编译前端项目，生成静态文件：

   npm run build
   

6. 在后端项目中，配置数据库连接信息（位于 report-core 目录下的 application.yml 文件中）。
7. 运行后端项目，启动服务：

   cd report-core
   mvn spring-boot:run
   

问题二：如何在项目中添加新的数据源？

解决步骤：

1. 在 report-core 目录下的 application.yml 文件中添加新数据源的配置信息。
2. 根据添加的数据源类型，在项目中添加相应的驱动依赖。
3. 重启项目，确保新数据源配置生效。

问题三：遇到编译错误或运行时异常怎么办？

解决步骤：

1. 检查项目依赖是否齐全，使用 mvn clean install 命令重新编译项目。
2. 查看错误信息，定位问题所在。
3. 根据错误信息，搜索相关问题的解决方案，或者在项目 GitHub Issues 页面查找是否有人遇到过类似问题。
4. 如果问题依然无法解决，可以在项目 Issues 页面提交新的问题，等待社区成员或项目维护者的解答。