快速开始

本指南帮助你在本地快速启动 ANGRY ANT 全栈项目，完成从安装依赖到验证运行的完整流程。

环境要求清单

• 移动端（aant-uniapp-base）
  • Node.js：>= 20.10.0
  • HBuilderX：>= 5.06
• PC端（aant-vben-admin）
  • Node.js：>= 20.10.0
  • pnpm：>= 9.12.0
• 后端
  • Java：1.8
  • Maven：>= 3.5
  • MySQL：>= 5.7
  • Redis：>= 5.0

项目克隆

git clone https://gitee.com/woshilgx/aant-boot-open.git
cd aant-boot-open

后端启动

1. 安装后端依赖

cd angryant-platform
mvn -U clean install -DskipTests

2. 配置数据库和 Redis

修改配置文件（位于 angryant-admin/src/main/resources/）：

application-druid.yml（数据源）：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_db?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: your_password

application.yml（Redis）：

spring:
  redis:
    host: 127.0.0.1
    port: 6379
    password: your_password

3. 初始化数据库

按顺序执行 SQL 脚本：

1. angryant-platform/angryant-framework/doc/sql/ — 平台基础表（必须）
2. angryant-oss/create.sql — OSS 建表脚本（如使用 OSS）
3. angryant-customer/ddl.sql — 客户模块（如使用客户管理）

4. 启动后端

在 IDE 中直接运行业务模块的启动类（如 angryant-biz-blank 中的 vip.angryant.BussiApplication）。

或使用 Maven 命令启动：

# 在业务模块目录下（如 angryant-biz-blank）
cd angryant-biz-blank
mvn spring-boot:run

5. 验证后端

启动成功后，默认监听端口 8080，访问 http://localhost:8080 验证服务是否正常。

后端打包部署

开发完成后，在业务模块中执行打包：

# 进入业务模块目录
cd angryant-biz-blank

# Maven 打包
mvn clean package

打包产物：

target/
├── output.zip          # 完整部署包（可直接上传服务器）
└── output/             # 解压后的部署文件
    ├── angryant-biz-blank.jar   # 应用 jar
    ├── lib/                      # 依赖 jar 包
    ├── application-prod.yml      # 生产环境配置
    ├── logback-prod.xml          # 日志配置
    ├── run.sh                    # Linux 启动脚本
    └── run.bat                   # Windows 启动脚本

详细的部署流程请参考 生产环境部署 章节。

PC 端启动

1. 安装前端依赖

cd aant-vben-admin
pnpm install

2. 配置环境变量

检查 .env.development 文件中的 API 地址：

# 后端 API 地址（9966 为开发环境端口，请根据实际配置修改）
VITE_GLOB_API_URL=http://localhost:9966

3. 启动开发服务器

pnpm dev

默认访问地址：http://localhost:5666

4. 构建生产版本

pnpm build

构建产物位于 apps/web-ele/dist/ 目录。

移动端启动

方式一：HBuilderX（推荐）

1. 使用 HBuilderX 打开 aant-uniapp-base 项目目录
2. H5 调试：点击 "运行" → "运行到浏览器" → 选择 Chrome
3. 构建 H5：点击 "发行" → "网站-PC Web 或手机 H5"
4. 构建微信小程序：点击 "发行" → "小程序-微信"

方式二：命令行（适合 CI/CD）

cd aant-uniapp-base
npm install

# 开发调试（H5 模式）
npm run dev

# 构建 H5
npm run build:h5

# 构建微信小程序
npm run build:mp-weixin

构建前检查 .env.js 中的 API 地址等环境配置。

常用开发命令

PC 端（aant-vben-admin）

pnpm dev           # 启动开发服务器
pnpm build         # 构建生产版本
pnpm build:analyze # 构建并分析打包体积
pnpm lint          # ESLint 检查
pnpm format        # Prettier 格式化
pnpm check:type    # TypeScript 类型检查

后端（angryant-biz-blank）

mvn clean install -DskipTests    # 编译打包（首次或依赖变更时）
mvn spring-boot:run              # 启动应用
mvn clean package                # 打包部署产物（生成 target/output.zip）
mvn test                         # 运行测试

首次运行验证

按以下顺序启动并验证：

1. 启动 MySQL 和 Redis — 确保数据库和缓存服务正常运行
2. 启动后端服务 — 查看日志无连接异常
3. 启动 PC 端 — 访问管理端，使用测试账号登录，验证权限与页面加载
4. 启动移动端（如需要） — H5 运行，打开浏览器控制台，确认网络请求成功

故障排除

问题	排查方向
后端数据库连接失败	核对 application-druid.yml 中的 MySQL 地址、用户名、密码
后端 Redis 连接失败	核对 application.yml 中的 Redis host/port/password
前端 Node 版本不满足	升级 Node.js 至 >= 20.10.0
前端 pnpm 版本不满足	npm install -g pnpm@latest
Token 校验失败	核对 application.yml 中的 token.header、token.secret
Mock 服务跨域问题	检查 nitro.config.ts 中的 CORS 配置
移动端无法运行	确认 HBuilderX 版本与平台插件；检查 manifest.json 配置