jcalaBlog打包上线全流程：从Gradle构建到服务器部署的完整指南

jcalaBlog打包上线全流程：从Gradle构建到服务器部署的完整指南

【免费下载链接】jcalaBlog项目地址: https://gitcode.com/gh_mirrors/jca/jcalaBlog

jcalaBlog打包上线，其实没有想象中那么难。jcalaBlog 是一款基于 Spring Boot + MyBatis + Velocity 构建的开源个人博客系统，自带后台管理、Markdown 编辑、黑夜模式、标签归档等功能，非常适合用来学习完整的 Java Web 项目部署流程。本文面向刚接触 Spring Boot 的开发者，以"本地跑通 → Gradle 构建 → 服务器部署"为主线，用最少的代码、最清晰的步骤，带你走完 jcalaBlog 打包上线全流程，让博客真正跑在公网服务器上。

一、先认识 jcalaBlog：开箱即用的个人博客系统

在动手部署之前，先花一分钟了解这个项目。jcalaBlog 的技术选型非常经典，几乎涵盖了 Java Web 开发的常用组件：

项目自带了一键黑夜模式、后台博客管理、Markdown 编辑器等完整功能，前端页面也已经全部写好，我们部署阶段完全不需要改动业务代码，只需要关注构建、配置和运行这三件事。

二、打包前的准备工作：环境与源码获取

开始之前，请确认本地环境满足以下最低要求：

获取源码非常简单，直接克隆仓库即可：

git clone https://gitcode.com/gh_mirrors/jca/jcalaBlog

克隆完成后，项目根目录下就能看到gradlew、build.gradle、docker-compose.yml等关键文件。其中docker-compose.yml里已经内置了 MySQL 5.7.17 的容器配置（root 密码为 root），本地调试时可以免去手动装数据库的麻烦。

三、本地先跑起来：开发环境的快速验证

正式打包前，强烈建议先在本地把项目跑通一次，避免把环境问题带到服务器上。

第一步，创建数据库。项目默认连接名为jcala_blog的数据库（连接配置在src/main/resources/application-dev.yml中）。开发模式下 Spring Boot 会自动执行import.sql和data.sql完成建表与初始数据导入，所以你只需在 MySQL 里建好空库即可。

第二步，启动项目。打开src/main/java/me/jcala/blog/Application.java，直接运行 main 方法，或者在项目根目录执行：

./gradlew bootRun

启动成功后访问http://localhost:8080，就能看到博客首页。后台管理入口为http://localhost:8080/admin，初始账号密码是admin / admin。

本地验证通过后，就可以放心进入下一环节：Gradle 构建打包。

四、核心打包命令：用 Gradle 构建可执行 Jar

jcalaBlog 使用 Spring Boot 官方 Gradle 插件打包，build.gradle中已经通过jar { baseName = 'app' }指定了产物名称。执行构建命令：

./gradlew clean build

构建完成后，在build/libs/目录下会生成一个名为app.jar的可执行 Jar 包。这个 Jar 是"胖包"，已经内嵌了 Undertow 容器、所有依赖和静态资源，单文件即可运行，这正是 Spring Boot 部署起来如此轻量的原因。

如果只想单独产出 Jar 而不跑测试，可以使用：

./gradlew bootJar

打包产物就是你要上传到服务器的那一个文件，这也是 jcalaBlog 打包上线全流程中最关键的一步。

五、服务器环境配置：数据库与生产参数

服务器端需要准备的软件与本地几乎一致：JDK 1.8、MySQL 5.7。这里有两个高频坑，提前帮你排掉：

• 中文乱码：在 Linux 下编辑 MySQL 配置文件，在[mysqld]段添加character-set-server=utf8，然后重启 MySQL 服务；
• 生产端口：生产配置application-prod.yml中默认监听 80 端口，无需 Nginx 反代也能直接访问。

接着创建数据库并导入项目根目录下docker-compose.yml对应的 MySQL 实例，或手动执行：

CREATE DATABASE jcala_blog DEFAULT CHARACTER SET utf8;

注意：生产配置中initialize: false，意味着不会像开发模式那样自动建表导数据，所以你需要在服务器上手动执行项目里的import.sql/data.sql完成初始化。

另外，图片上传的保存目录在application-prod.yml的pic.home配置项中，上线前请改成服务器上的真实路径，否则后台传图会失败。

六、上传并启动：java -jar 一键部署

一切就绪后，把build/libs/app.jar上传到服务器任意目录（例如/opt/jcalaBlog/），然后执行启动命令：

java -jar app.jar --spring.profiles.active=prod

--spring.profiles.active=prod会强制加载生产配置，让服务以 80 端口、生产参数运行。想要后台常驻并记录日志，推荐这样启动：

nohup java -jar app.jar --spring.profiles.active=prod > blog.log 2>&1 &

启动完成后，直接在浏览器访问服务器 IP 或已解析的域名，jcalaBlog 就正式上线了。以后每次更新，只需重新构建 Jar、覆盖文件、重启进程即可，整个发布周期可以控制在几分钟内。

七、常见问题排查清单

部署过程中如果遇到问题，先对照这张速查表：

八、小结

回顾整个 jcalaBlog 打包上线流程，其实只有四步：本地跑通、Gradle 构建、服务器配库、java -jar启动。这个项目麻雀虽小、五脏俱全，非常适合作为你的第一个 Spring Boot 实战部署项目。照着本文走一遍，你不仅能拥有一个自己的博客站点，更能在实战中把构建、配置、部署这条链路彻底打通。

【免费下载链接】jcalaBlog项目地址: https://gitcode.com/gh_mirrors/jca/jcalaBlog