# X-springboot

**Repository Path**: wang_zhu_ge/x-springboot

## Basic Information

- **Project Name**: X-springboot
- **Description**: -SpringBoot 是一个轻量级的Java快速开发平台，基于各大开源项目组合而来，用于快速构建中小型API、RESTful API项目，该项目已经有过多个真实项目的实践，稳定、简单、快速，使我们摆脱那些重复劳动。
本项目已大量重构,精简了大量代码减少第三方依赖，最干净的脚手架。






- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 3
- **Created**: 2022-08-03
- **Last Updated**: 2025-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1> X-SpringBoot </h1>

**项目说明** 
- X-SpringBoot 是一个轻量级的Java快速开发平台，基于各大开源项目组合而来，用于快速构建中小型API、RESTful API项目，该项目已经有过多个真实项目的实践，稳定、简单、快速，使我们摆脱那些重复劳动。
- 本项目已大量重构,精简了大量代码减少第三方依赖，最干净的脚手架。
- 引入了lombok 大量简化了代码
- 引入了MyBatis Plus 大量简化了SQL
- 引入hutool 工具包 规范工具类
- 引入minio 分布式文件系统
- 引入[autoFull](https://github.com/yzcheng90/zhjg-common-autofull) 自动填充绑定框架,多表关联不用写sql
- 前后端完全脱离，前端代码可单独部署
- 自定义Spring Security 支持获取token
- 账号密码：admin/admin

 
**版本信息** 
- 核心框架：Spring Boot 2.4.4
- 安全框架：Spring Security 
- 视图框架：Spring MVC 5.3.x
- 持久层框架：MyBatis Plus 3.4.2
- 日志管理：SLF4J 1.7、Log4j
- 页面交互：Vue2.x 


**环境** 
- jdk 1.8
- mysql 5.7+
- redis
- nginx


**项目结构** 
```
X-SpringBoot
├─doc  
│  ├─db.sql 项目SQL语句
│  ├─nginx.confi nginx 配置文件
│  ├─updateLog 更新日志
│
├─authentication 权限认证
├─common 公共模块
│  ├─annotation 自定义注解
│  ├─aspect 系统日志
│  ├─base base包
│  ├─exception 异常处理
│  ├─utils 一些工具类
│  └─xss XSS过滤
│ 
├─config 配置信息
├─interceptor token拦截器
│ 
├─modules 功能模块
│  ├─app API接口模块(APP调用)
│  ├─oss 文件服务模块
│  ├─sys 权限模块
│  ├─apkversion APK 版本管理
│  └─gen 代码生成
│ 
├─Application 项目启动类
│  
├──resources 
│  ├─mapper SQL对应的XML文件


```
**部署** 
- 后台部署
 ```
   1、 $git clone https://github.com/yzcheng90/X-SpringBoot.git
   
   2 、IDEA 打开项目引入依赖
   
   3、 创建数据库x_springboot，数据库编码为UTF-8，执行doc/db.sql文件，初始化数据
   
   4、 IDEA运行Application.java，则可启动项目 http://localhost:8080
 ```
- 前台部署
 ```
    1、 打开nginx 目录 /conf/nginx.conf 
    
    2、 在server中修改 root 和 index  
        
        ...
        server {
            ....
            #静态页面目录
            root  E:\github\X-SpringBoot\x-springboot-ui;
            #默认首页
            index  login.html;
            ....
            
            location ^~// {
                 proxy_pass   http://127.0.0.1:8080; #这里为后台服务地址
            }
        }
        ...
        
        ( 这里建议直接复制项目中的doc/nginx.conf替换你的nginx配置文件，然后修改静态页面目录 )
        
     3、启动nginx 访问 localhost
 ```

**系统截图**
![输入图片说明](pic/20190419153826.jpg)
![输入图片说明](pic/20190422163331.jpg)
![输入图片说明](pic/20190422163826.jpg)

**常见问题**

1、启动报错
```
 是因为依赖没有引入  maven --> 先clear 再reimport 重新引入
```
2、验证码获取失败
```
1) redis没有启动
2) nginx 没有配置好
3) 如果部署的不是同一台机器，前台common.js中的url要改成ip

```
3、数据库连接不上（mysql 5.7）

```
1) 看看application.yml 配置文件中 spring.profiles.active: dev  
   当前配置的是dev ,就修改application-dev.yml 中的数据库连接IP用户密码
2) 如果改完了还是不行，看看你mysql版本8.0以上 须要修改pom.xml中的 mysql-connector-java 的版本

```
4、启动了nginx 还是不能访问前台
```
1) 确认一下nginx.conf 配置有没有问题

2）把所有的nginx的进程都结束再启动试试 （一般有很多个nginx的进程，结束一个再重新启动也是没用的）

3）如果项目目录名带T开头，nginx.conf 里面的目录要 双反斜杠 \\  或改为 正斜杠 / 

```


 **最后**

- 如果喜欢，记得star fork 谢谢您的关注 x-springboot会持续维护