项目导入与启动（后端）

简述

在 IDEA 中导入 mms 克隆后的 mms Maven 工程根，配置 JDK 21、MySQL / Redis，启动 mms-admin 中的 MmsAdminApplication。管理端前端在独立仓库 mms-ui，见 MMS-UI 使用指南。

说明

MMS-UI 是 Vue3 管理端前端；本文聚焦 Java 后端 导入与启动，勿与上一段混淆。

获取项目

• 克隆与工作区说明：开始 — 获得项目（mms 与 mms-ui 双仓并列）。
• 前端日常 Git：前端 mms-ui：日常 Git（双仓并列）。

项目导入 IDEA

依赖下载

Maven项目依赖下载,因为项目pom文件有制定镜像源地址，所以不用担心下载速度

<repositories>
        <repository>
            <id>public</id>
            <name>huawei nexus</name>
            <url>https://mirrors.huaweicloud.com/repository/maven/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
</repositories>

<pluginRepositories>
        <pluginRepository>
            <id>public</id>
            <name>huawei nexus</name>
            <url>https://mirrors.huaweicloud.com/repository/maven/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
</pluginRepositories>

Maven的路径

• （我这里选择的是idea自带的，个人觉得搭配上上面的镜像源制定后挺好用的）

JDK的配置

• 推荐 JDK 21（与主仓 pom.xml 中 java.version 一致）

编码设置

【可选】在菜单栏中选择“Help” -> “Edit Custom VM Options”，在文件末尾添加“-Dfile.encoding=UTF-8”。

环境切换

Profiles方式切换配置环境来动态改变 spring.profiles.active 的值

每次切换环境，记得刷新一下配置

• dev：开发环境
• local：本地环境
• prod：生产环境

确保每个模块的 Dependencies 依赖下载完整

下载依赖

• 执行Maven 父工程中的 install 命令
• 执行全部成功出现 BUILD SUCCESS 则代表依赖已全部下载就绪

后端技术栈（约）

技术栈	备注	技术栈	备注
Spring Boot 3.5.x	见根 pom.xml spring-boot.version	Sa-Token 1.44.x	见 satoken.version
Undertow	随 Spring Boot	Jakarta Validation	校验
Spring Boot Admin 3.5.x	可选监控	Actuator	运维端点
dynamic-datasource	多数据源	JWT（随 Sa-Token）	令牌
MyBatis-Plus	ORM	Redisson	Redis 客户端
P6Spy	SQL 分析（可选）	PowerJob	任务调度（mms-zoom）
x-file-storage 等	文件存储	sms4j 等	短信等

启动入口

• 继承核心功能在 mms-framework 模块中实现

<dependency>
    <groupId>com.sxpcwlkj</groupId>
    <artifactId>mms-framework</artifactId>
</dependency>

• 后台 启动入口 在 mms-admin（MmsAdminApplication）；业务能力在 mms-modules 各子模块（如 mms-system）及按需引入的 mms-servers 能力（如 mms-cms）中实现

数据的导入

备注:

• 若有数据库客户端：建库 mms（或与配置一致），执行 mms 仓库下的 script/db/mms.sql。

数据库管理客户端

• 链接数据库

• 导入数据到，执行 mms.sql 文件

执行 script/db/mms.sql

命令方案。

更多的命令教程，请前往 Mysql随笔

连接到 MySQL 服务器

mysql -u root -p

然后输入 root 用户的密码。

• 新建数据库 mms

创建数据库

CREATE DATABASE mms;

创建用户

# 本地访问
CREATE USER 'mms'@'localhost' IDENTIFIED BY '123456';
-- 或者
CREATE USER 'mms'@'127.0.0.1' IDENTIFIED BY '123456';

# 可远程访问
CREATE USER 'mms'@'%' IDENTIFIED BY '123456';

用户授权数据库 详细教程

# 本地访问
GRANT ALL PRIVILEGES ON mms.* TO 'mms'@'localhost';
-- 或者
GRANT ALL PRIVILEGES ON mms.* TO 'mms'@'127.0.0.1';

# 远程访问
GRANT ALL PRIVILEGES ON mms.* TO 'mms'@'%';

刷新权限【重要】

FLUSH PRIVILEGES;

配置数据库

• 修改配置文件的数据库账户、密码，这里以 local 环境为例

# 数据库账户
username: mms
# 数据库密码
password: 123456

配置Redis

• 配置地址 host、端口号：port、密码：password、数据库：database
• 如果没有密码把 password 删除/注释 即可

• 启动成功后控制台看到一下内容

配置运行看板

本人常用的几个工具

• Docker：自动识别配置的DockerFile启动项，可以快速制作镜像推送到服务器环境容器中；
• Npm：自动识别前端项目的启动项，启动nodejs项目；
• Springboot ：自动识别项目Springboot启动项。

选择后没有启动列表？

只有配置启动项，才能被运行看板识别

启动项目

1. 检查好数据库信息，redis信息配置正确；
2. 执行MmsAdminApplication 启动；
3. 看到控制台打印下图信息说明后端启动成功。

文档修订（2026-04-03）

后端启动模块 mms-admin（MmsAdminApplication）；JDK 21、Maven、revision 以 mms/pom.xml 为准。前端 mms-ui 为独立仓库，获取方式见 开始。技术栈版本号请以仓库内 dependencyManagement 为准，上表为便于阅读的约值。