# 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

X-SpringBoot

**项目说明** - 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会持续维护