本地工程导入

本章给出从零把 Harness 工程在本地跑起来的具体命令与配置改点，不做原理讲解。

本工程为非开源项目，请先获取到工程源码后再进行以下操作。

1. 安装环境

工具	版本	校验命令
JDK	21 及以上	java -version
Maven	3.9 及以上	mvn -v
Node.js	18 及以上	node -v
pnpm	8 及以上	pnpm -v
MySQL	8 及以上	——
Redis	任意稳定版	——

2. 导入 IDE

用 IntelliJ IDEA「Open」选择工程根目录的 pom.xml（以 Maven 工程方式打开），等待依赖下载完成。

3. 建数据库

只需建一个空库，表结构由框架的 actable 在首次启动时自动创建（application-dev.yml 中 actable.table.auto: update），无需手工执行建表脚本。

CREATE DATABASE dev_alinesno_infra_harness_v100 DEFAULT CHARACTER SET utf8mb4;

定时任务（Quartz）需要额外执行一次建表脚本：alinesno-infra-harness-boot/src/main/resources/ddl/quartz-mysql-ddl.sql。

4. 改本地配置

配置文件都在 alinesno-infra-harness-boot/src/main/resources/ 下：

• application-dev.yml：改这三处即可
  • spring.datasource.url / username / password → 指向上一步建的库
  • spring.data.redis.host / port → 指向本地 Redis
  • server.port → 默认 22301，端口被占时改这里
• config/harness.yml：模块开关与行为参数（沙箱、积分、连接器等），本地开发一般不用动
• config/alinesno-scheduler.yml：定时任务调度参数，不用动

注意：config/harness.yml 的优先级高于 application-dev.yml，同名键以 harness.yml 为准。要临时覆盖用 -D 系统属性或环境变量。

5. 编译

在工程根目录执行：

mvn clean compile -DskipTests

6. 启动后端

任选一种：

命令行

cd alinesno-infra-harness-boot
mvn spring-boot:run -Dspring-boot.run.profiles=dev

IDEA：运行主类 com.alinesno.infra.harness.HarnessApplication，在 Run Configuration 的 Active profiles 填 dev。

启动成功后监听 http://localhost:22301。

7. 启动前端

cd alinesno-infra-harness-ui
pnpm install
pnpm dev

按控制台提示的本地地址访问，联调请求经 Vite 代理转发到后端 22301。

8. 验证

• 后端进程无异常退出、日志出现 Started HarnessApplication。
• 数据库自动建出业务表（actable 首次启动生成）。
• 前端页面能打开、能登录。

常见问题

• 依赖下载慢：给 Maven / pnpm 配就近镜像源。
• 端口占用：改 application-dev.yml 的 server.port，前端代理目标同步改。
• 表没建出来：确认 application-dev.yml 里数据源指向的是本工程的空库，且账号有建表权限。
• Quartz 报错：确认已执行 ddl/quartz-mysql-ddl.sql。