Java 项目实战：尚庭公寓单体架构开发与部署

尚庭公寓单体架构项目实战教程，涵盖从环境搭建到生产部署的全流程。技术栈包括 Spring Boot 3.0.5、MyBatis-Plus、Knife4j、MinIO 对象存储及 JWT 认证。内容涉及 Web 模块配置、数据库初始化、基础 CRUD 接口开发、文件上传实现、全局异常处理、前后端联调以及 Nginx 反向代理部署。旨在帮助开发者掌握企业级 Java 应用的核心开发模式与运维方案。

开源信徒发布于 2026/3/16更新于 2026/5/2919 浏览

Java 项目实战：尚庭公寓单体架构开发与部署

一、前期准备

1、课程简介

项目介绍

项目界面

前期准备

安装 MySQL
初始化数据库
安装 Maven 并配置阿里云镜像仓库
安装 JDK 17
安装 IDEA

二、笔记总结

1、IDEA 创建项目

项目创建

项目结构

依赖管理

2、父工程添加版本管理依赖

<!-- 继承 Spring Boot 父项目 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <>spring-boot-starter-parent
    3.0.5



    17
    17
    UTF-8
    3.5.3.1
    2.9.2
    0.11.2
    1.6.2
    8.2.0
    4.1.0
    2.0.23



    
        
        
            com.baomidou
            mybatis-plus-boot-starter
            ${mybatis-plus.version}
        
        
        
            com.github.xiaoymin
            knife4j-openapi3-jakarta-spring-boot-starter
            ${knife4j.version}
        
        
        
            io.jsonwebtoken
            jjwt-api
            ${jwt.version}
        
        
            io.jsonwebtoken
            jjwt-impl
            runtime
            ${jwt.version}
        
        
            io.jsonwebtoken
            jjwt-jackson
            runtime
            ${jwt.version}
        
        
        
            com.github.whvcse
            easy-captcha
            ${easycaptcha.version}
        
        
        
            io.minio
            minio
            ${minio.version}
        
        
        
            com.aliyun
            dysmsapi20170525
            ${aliyun.sms.version}

<!-- 包含 spring web 相关依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 包含 spring test 相关依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

<!-- Spring Boot Maven 插件，用于打包可执行的 JAR 文件 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

server:
  port: 8080

@SpringBootApplication
public class AdminWebApplication {
    public static void main(String[] args) {
        SpringApplication.run(AdminWebApplication.class, args);
    }
}

<!-- mybatis-plus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>
<!-- mysql 驱动 -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
</dependency>

<!-- mybatis-plus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>

spring:
  datasource:
    type: com.zaxxer.hikari.HikariDataSource
    url: jdbc:mysql://<hostname>:<port>/<database>?useUnicode=true&characterEncoding=utf-8&useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=GMT%2b8
    username: <username>
    password: <password>
    hikari:
      connection-test-query: SELECT 1 # 自动检测连接
      connection-timeout: 60000 # 数据库连接超时时间，默认 30 秒
      idle-timeout: 500000 # 空闲连接存活最大时间，默认 600000（10 分钟）
      max-lifetime: 540000 # 此属性控制池中连接的最长生命周期，值 0 表示无限生命周期，默认 1800000 即 30 分钟
      maximum-pool-size: 12 # 连接池最大连接数，默认是 10
      minimum-idle: 10 # 最小空闲连接数量
      pool-name: SPHHikariPool # 连接池名称
# 用于打印框架生成的 sql 语句，便于调试
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

@Configuration
@MapperScan("com.atguigu.lease.web.*.mapper")
public class MybatisPlusConfiguration {}

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
</dependency>

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
</dependency>

@Configuration
public class Knife4jConfiguration {
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI().info(new Info().title("后台管理系统 API").version("1.0").description("后台管理系统 API"));
    }
    @Bean
    public GroupedOpenApi systemAPI() {
        return GroupedOpenApi.builder().group("系统信息管理").pathsToMatch("/admin/system/**").build();
    }
    @Bean
    public GroupedOpenApi loginAPI() {
        return GroupedOpenApi.builder().group("后台登录管理").pathsToMatch("/admin/login/**","/admin/info").build();
    }
    @Bean
    public GroupedOpenApi apartmentAPI() {
        return GroupedOpenApi.builder().group("公寓信息管理").pathsToMatch("/admin/apartment/**","/admin/room/**","/admin/label/**","/admin/facility/**","/admin/fee/**","/admin/attr/**","/admin/payment/**","/admin/region/**","/admin/term/**","/admin/file/**").build();
    }
    @Bean
    public GroupedOpenApi leaseAPI() {
        return GroupedOpenApi.builder().group("租赁信息管理").pathsToMatch("/admin/appointment/**","/admin/agreement/**").build();
    }
    @Bean
    public GroupedOpenApi userAPI() {
        return GroupedOpenApi.builder().group("平台用户管理").pathsToMatch("/admin/user/**").build();
    }
}