X-SpringBoot

项目说明

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

版本信息

核心框架：Spring Boot 2.1.8
安全框架：Spring Security
视图框架：Spring MVC 5.1.x
持久层框架：MyBatis Plus 3.1.0
日志管理：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 一些工具类
│  ├─validator 后台校验
│  └─xss XSS过滤
│ 
├─config 配置信息
├─interceptor token拦截器
│ 
├─modules 功能模块
│  ├─app API接口模块(APP调用)
│  ├─oss 文件服务模块
│  ├─sys 权限模块
│  ├─apkversion APK 版本管理
│  └─gen 代码生成
│ 
├─Application 项目启动类
├─Swagger2 swagger2类
│  
├──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

系统截图

常见问题

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 里面的目录要 双反斜杠 \\  或改为 正斜杠 /

最后

交流QQ群：17470566
本人QQ：913624256
如果喜欢，记得star fork 谢谢您的关注 x-springboot会持续维护

Ruffianjiang/x-springboot

X-SpringBoot