🚀 一、代码下载
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：添加缺失的网关路由配置
其他补充：
-
使用的是Windows系统，前端工具为WebStorm🌪️，后端工具为IntelliJ IDEA🧠，JDK版本为1.8。 -
必须运行的后端服务有： auth,gateway,system,ncnb，启动顺序无关。后端架构图 链接。 -
默认用户名为 admin👤，密码可直接更改数据库中的martin.sys_user表，密码设为123456：{bcrypt}$2a$10$OkYvg18brhmFXLYUygOhe.TthPfFIKoqfZqGOZnDZ7yLsXsfGh/Yy。
希望大家项目运行顺利！🙌🎉
本文由 mdnice 多平台发布
