服务端
打包
如何将 Free FS 服务端编译并打包成可执行文件。
方式一:命令行打包(Maven)
步骤 1:编译项目
在项目根目录下运行 Maven 命令进行全量编译和安装:
mvn clean install -DskipTests说明:
clean:清理之前的编译产物install:编译并安装到本地 Maven 仓库-DskipTests:跳过测试,加快编译速度(可选)
步骤 2:打包可执行 JAR
进入管理后台模块 fs-admin 进行打包:
cd fs-admin
mvn clean package -DskipTests说明:
package:打包成 JAR 文件- 打包完成后,在
fs-admin/target目录下会生成可执行的 JAR 包
步骤 3:查看打包结果
打包完成后,在 fs-admin/target 目录下会生成一个可执行的 JAR 包,通常命名为 fs-admin.jar(或带版本号,如 fs-admin-2.0.0.jar)。
ls -lh fs-admin/target/*.jar方式二:IDE 打包(IntelliJ IDEA)
步骤 1:打开 Maven 工具窗口
- 在 IntelliJ IDEA 中打开项目
- 点击右侧边栏的 Maven 工具窗口(或使用快捷键
Alt + 9) - 展开项目结构,找到
fs-dependencies和fs-admin模块

步骤 2:编译项目
- 在 Maven 工具窗口中,展开
fs-dependencies模块 - 双击执行
Lifecycle→install命令 - 等待编译完成(控制台会显示编译进度和结果)
步骤 3:打包可执行 JAR
- 在 Maven 工具窗口中,展开
fs-admin模块 - 双击执行
Lifecycle→package命令 - 等待打包完成

步骤 4:查看打包结果
打包完成后,在项目文件树中查看 fs-admin/target 目录,可以看到生成的 JAR 文件。
验证打包结果
无论使用哪种方式打包,最终都会在 fs-admin/target 目录下生成可执行的 JAR 文件。你可以通过以下方式验证:
查看文件信息
# Windows
dir fs-admin\target\*.jar
# Linux/Mac
ls -lh fs-admin/target/*.jar运行 JAR 文件(测试)
cd fs-admin/target
java -jar fs-admin.jar注意:运行前请确保已配置好数据库、Redis 等依赖服务,否则启动会失败。
常见问题
Q: 打包时出现依赖找不到的错误?
A: 确保先执行了 fs-dependencies 模块的 install 命令,将依赖安装到本地 Maven 仓库。
Q: 打包后的 JAR 文件很大?
A: 这是正常的,因为 Spring Boot 的可执行 JAR 包含了所有依赖。如果需要减小体积,可以考虑使用 Spring Boot 的分层 JAR 或 Docker 镜像。
Q: 如何指定打包的版本号?
A: 版本号在 fs-dependencies/pom.xml 中的 <revision> 属性中定义,修改后重新打包即可。
Q: 打包时跳过测试有什么影响?
A: -DskipTests 只是跳过测试执行,不会影响编译和打包。如果希望运行测试,可以去掉这个参数。