ERD Online 快速启动指南：代码下载到首次运行的全流程攻略 ️

🚀 一、代码下载

ERD online前端代码正常拉取即可👌

后端代码含有子模块，拉取命令如下：

git clone --recurse-submodules https://github.com/www-zerocode-net-cn/martin-framework.git

🛠️ 二、代码构建

🌐 前端代码构建

前端工程使用yarn🧶作为包管理器，如果未安装yarn，请先安装：

npm install -g yarn
yarn --version  # 检查yarn是否成功安装

如果出现yarn: command not found错误，可前往这里查看解决方法。

安装前端依赖包：

yarn  # 直接在终端执行
# 更换淘宝源并设置超时时间
yarn config set registry 'https://registry.npm.taobao.org'
yarn add yourPackageHere --network-timeout 600000

处理构建错误：

删除package.json中的"packageManager": "yarn@pnpm@7.3.0"或启用Corepack：

corepack enable

更改前端项目接口地址，在env-config.js中替换：

window._env_ = {
  API_URL: "http://127.0.0.1:9502",
  ERD_API_URL: "http://127.0.0.1:9502",
};

🔧 后端代码构建

执行数据库脚本，并确保nacos版本为1.4.2或兼容版本。

处理依赖问题：

如果遇到xjar-maven-plugin下载失败，注释或修改依赖：

<!-- 注释或修改版本 -->
<groupId>com.github.core-lib</groupId>
<artifactId>xjar-maven-plugin</artifactId>
<version>4.0.1</version>

版本不对时，修改pom.xml中的版本号：

<parent>
    <artifactId>martin-extension</artifactId>
    <groupId>com.java2e</groupId>
    <version>1.0.8</version>
</parent>

🖥️ 三、本地启动项目

后端服务启动时可能遇到的问题及解决方案：

• MartinExtensionNcnbApplication中 OssTemplate注入失败：使用 @Autowired(required = false)
• MartinBizSsoApplication中 RemoteTokenServices重复定义：使用 @Primary注解
• MartinExtensionLocoApplication缺失数据库 loco：暂时忽略项目
• MartinExtensionNcnbApplication中 OpenAiUtil.OpenAiClient注入失败：添加缺失配置或注释
• MartinExtensionNcnbApplication中 OpenAiConfiguration报错：注释掉spring注解
• MartinBizAuthApplication启动报错：更改配置文件中的地址
• MailProperties注入失败：注释掉本地yml文件中的group和namespace配置
• 前后端都正常启动，但登录接口返回403：添加缺失的网关路由配置

其他补充：

1. 使用的是Windows系统，前端工具为WebStorm🌪️，后端工具为IntelliJ IDEA🧠，JDK版本为1.8。
2. 必须运行的后端服务有： auth, gateway, system, ncnb，启动顺序无关。后端架构图 链接。
3. 默认用户名为 admin👤，密码可直接更改数据库中的 martin.sys_user表，密码设为123456： {bcrypt}$2a$10$OkYvg18brhmFXLYUygOhe.TthPfFIKoqfZqGOZnDZ7yLsXsfGh/Yy。

希望大家项目运行顺利！🙌🎉

本文由 mdnice 多平台发布