Skip to content

Commit dbeeef8

Browse files
committed
docs: update JDK and Maven version requirements, add common issues section with solutions
1 parent cd7e1d3 commit dbeeef8

File tree

1 file changed

+50
-1
lines changed

1 file changed

+50
-1
lines changed

manual/source_run.md

Lines changed: 50 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@
5353

5454
!!! Abstract ""
5555

56-
📌 提示:确保已正确安装 JDK 21 及以上版本和 Maven 环境
56+
📌 提示:确保已正确安装 JDK 21 Maven 3.8.6 及以上版本和环境
5757

5858
执行以下命令构建后端模块(如 `framework`、`crm`、`app` 等)并安装到本地仓库:
5959

@@ -188,3 +188,52 @@
188188
```bash
189189
./mvnw clean package
190190
```
191+
## 6 常见问题
192+
193+
!!! abstract ""
194+
195+
**Q1:构建过程中遇到依赖下载失败怎么办?**
196+
197+
A:如果出现以下错误:
198+
199+
200+
[ERROR] Failed to execute goal on project backend: Could not resolve dependencies
201+
[ERROR] dependency: cn.cordys:quartz-spring-boot-starter:jar:1.0.0 (compile)
202+
203+
204+
请在本地 Maven 仓库配置中添加以下镜像源:
205+
206+
207+
<repositories>
208+
<repository>
209+
<id>cordys</id>
210+
<url>https://repository.fit2cloud.com/repository/public</url>
211+
<releases>
212+
<enabled>true</enabled>
213+
</releases>
214+
<snapshots>
215+
<enabled>true</enabled>
216+
</snapshots>
217+
</repository>
218+
</repositories>
219+
220+
221+
**Q2:运行前端项目时报错缺少模块怎么办?**
222+
223+
A:请确保已正确执行以下命令安装所有依赖:
224+
225+
pnpm i -w
226+
227+
如果问题仍然存在,可以尝试删除 `node_modules` 目录并重新安装依赖。
228+
229+
230+
**Q3:后端启动时报错数据库连接失败怎么办?**
231+
232+
A:请检查 `cordys-crm.properties` 配置文件中的数据库连接信息是否正确,包括 IP 地址、端口、数据库名称、用户名和密码。
233+
234+
235+
**Q4:如何修改默认的服务器端口?**
236+
237+
A:可以在 `cordys-crm.properties` 文件中添加或修改:
238+
239+
server.port=8081

0 commit comments

Comments
 (0)