中文 | [English](./README.md)
Jiscuss
基于java的简单论坛系统，Jiscuss = Java + Discuss。
---
Github 仓库 |
Gitee 仓库 |
在线体验
# 预览
[](https://imgchr.com/i/sykhy4)
# 简介
基于JAVA，使用SpringBoot + H2 Database + Semantic-UI + Freemarker 构建，官网：[[www.jiscuss.com]](http://www.jiscuss.com/)
# 在线体验
- [[DEMO地址]](http://demo.jiscuss.com/)
# 部署
## [一]、开发环境配置
```
// 需jdk 1.8以上，maven3以上。
```
## [二]、下载代码
```
// Github - https://gitee.com/chuyaoyuan/Jiscuss.git
// Gitee - https://github.com/Chuyaoyuan/Jiscuss.git
```
## [三]、运行启动(默认使用H2数据库，可以在配置文件切换MYSQL)
```
// 1、代码导入IDE
// 2、启动服务
// 4、访问地址
http://localhost
```
> 说明：以上为原始快速启动说明。当前升级后的 v2.0 分支已迁移到 Spring Boot 3，推荐使用 JDK 17 运行；旧版本中的 JDK 1.8 说明仅适用于早期分支。
## 当前升级版本说明
当前代码已完成 Spring Boot 3 兼容升级，主要技术栈如下：
- Java 17
- Spring Boot 3.3.5
- Spring Security 6
- Spring Data JPA / Hibernate 6
- FreeMarker
- H2 Database（开发环境默认）
- MySQL 8（生产/外部数据库环境）
- Flyway（数据库版本迁移）
- SpringDoc OpenAPI（替代 Springfox Swagger）
- Ehcache 3 + JCache
- Druid Spring Boot 3 Starter
- MapStruct
## 环境要求
- JDK：17+
- Maven：3.8+
- MySQL：8.x（仅 mysql profile 需要）
检查本地环境：
```
java -version
javac -version
mvn -version
```
## 构建与启动
### 使用默认 H2 开发环境
项目默认激活 `h2` profile：
```
mvn spring-boot:run
```
访问：
```
http://localhost
```
如果本机 Linux 普通用户无法绑定 80 端口，可以临时指定其他端口：
```
mvn spring-boot:run -Dspring-boot.run.arguments="--server.port=8080"
```
然后访问：
```
http://localhost:8080
```
### 使用 MySQL 环境
1. 创建数据库：
```
CREATE DATABASE jiscuss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```
2. 修改配置文件：
```
src/main/resources/application-mysql.yml
```
根据实际环境修改：
- `spring.datasource.url`
- `spring.datasource.username`
- `spring.datasource.password`
3. 启动 mysql profile：
```
mvn spring-boot:run -Dspring-boot.run.profiles=mysql
```
## 数据库迁移说明
项目已使用 Flyway 接管数据库初始化和后续变更，迁移脚本位于：
```
src/main/resources/db/migration/
```
当前迁移文件：
- `V1__init_schema.sql`：初始化表结构和基础数据
- `V2__security_updates.sql`：安全相关字段/数据升级
注意：旧的 `schema.sql` 和 `data.sql` 已不再使用，避免与 Flyway 重复初始化。
## 安全与管理端点
- 登录认证已迁移到 Spring Security 6 配置方式。
- `/admin/**`、`/actuator/**`、`/druid/**` 需要管理员角色访问。
- H2 Console 默认关闭；如需开发调试，可显式开启：
```
mvn spring-boot:run -Dspring-boot.run.arguments="--spring.h2.console.enabled=true"
```
- OpenAPI 文档地址：
```
http://localhost/swagger-ui.html
http://localhost/v3/api-docs
```
## 网络不佳时的构建建议
如果依赖已经下载到本地 Maven 仓库，可以使用离线模式：
```
mvn -o -DskipTests compile
```
如果首次构建尚未下载 Spring Boot 3.3.5 等依赖，离线模式会失败，需要在网络可用时先执行一次：
```
mvn -DskipTests compile
```
国内网络环境可配置 Maven 镜像源后再构建。依赖下载完成后，后续即可使用 `mvn -o` 离线构建。
## 常用检查命令
编译检查：
```
mvn -DskipTests compile
```
打包：
```
mvn -DskipTests package
```
运行 jar：
```
java -jar target/jiscuss-0.0.1-SNAPSHOT.jar
```
## 升级注意事项
- Spring Boot 3 使用 `jakarta.*` 命名空间，旧的 `javax.servlet`、`javax.persistence`、`javax.validation` 不再使用。
- Hibernate 6 可自动识别数据库方言，配置中无需手动指定 `database-platform`。
- MySQL 连接已移除不推荐的 `autoReconnect=true`。
- JSON 响应优先使用 Spring MVC + Jackson 自动序列化，不再依赖 `org.json`。
- WebSocket starter 已移除；如后续确实需要实时通信，再按功能重新引入。
## [四]、开源协议
[MIT](https://opensource.org/licenses/MIT)