JCM（君尘陌微服务系统）

基于 Spring Boot + Spring Cloud Alibaba 的微服务项目骨架

项目概览

• 注册/配置中心：Nacos（本项目默认端口映射为 8148）
• 网关：Spring Cloud Gateway
• 业务服务：认证、系统、代码生成、定时任务、监控、聚合文档、MCP 示例等
• 组件封装：jcm-framework 提供通用 Starter（Redis / Security / Swagger / MyBatis / Log / WebSocket 等）

技术栈（版本以根 pom.xml 为准）

依赖	版本
JDK	11
Spring Boot	2.7.18
Spring Cloud	2021.0.8
Spring Cloud Alibaba	2021.0.5.0
MyBatis-Plus	3.5.5
PageHelper	2.0.0
Knife4j	3.0.3
Fastjson2	2.0.43
Hutool	5.8.27
EasyExcel	4.0.2

模块结构

目录	说明
jcm-api	服务间调用 API（OpenFeign 接口等）
jcm-gateway	网关服务
jcm-modules	业务服务聚合（system / auth / gen / job / monitor / doc / mcp）
jcm-framework	通用 Starter 与基础能力封装

服务与端口（本地默认）

服务	Spring 应用名	端口
网关	jcm-gateway	8080
认证	jcm-auth	9211
系统	jcm-system	9201
代码生成	jcm-gen	9202
定时任务	jcm-job	9203
聚合文档	jcm-doc	9209
监控	jcm-monitor	8002
MCP 示例	jcm-mcp	8081
Nacos 控制台（docker）	nacos	8148
Redis（docker）	redis	6379

快速开始（本地）

1) 启动基础设施（Nacos + Redis）

docker compose -f docker-compose-nacos.yml up -d

• Nacos 控制台：http://localhost:8148/nacos/（默认账号密码：nacos / nacos）
• 说明：docker-compose-nacos.yml 中 Nacos 采用 MySQL 持久化（默认连接 host.docker.internal:3306/junchenmo_config），请按你的环境调整数据库地址与账号密码

2) 构建项目

mvn -DskipTests clean package

3) 启动服务（Windows 一键）

powershell -ExecutionPolicy Bypass -File .\start_services.ps1

脚本会尝试按 jar 路径启动网关与部分业务服务（依赖各模块已成功构建产物）。

配置说明

Nacos Config

网关与大多数服务启用了 Nacos Config，默认会读取：

• 网关：application-dev.yml（共享配置）
• 业务服务：${spring.application.name}-dev.yml（各服务独立配置）

如果你的 Nacos 中尚未创建上述配置，需要先在 Nacos 控制台新增对应 Data ID（Group 默认为 DEFAULT_GROUP，namespace 为 public）。

MySQL

部分服务（例如 jcm-auth）通过环境变量注入数据库连接：

• MYSQL_HOST / MYSQL_PORT / MYSQL_DATABASE
• MYSQL_USERNAME / MYSQL_PASSWORD

接口文档

• 聚合文档服务：jcm-doc（默认端口 9209）
• 常见入口：http://localhost:9209/doc.html

项目截图