Java Web实战：Spring Boot+MyBatis-Plus构建小区物业管理系统-编程实验室

简介：在软件开发领域，掌握一个完整的项目实战流程是提升工程能力的关键。从概念上讲，基于Java Web技术栈构建业务管理系统，是理解MVC设计模式、ORM对象关系映射和分层架构原理的经典实践。其技术价值在于，通过一个贴近真实业务场景的项目，开发者能系统性地串联需求分析、数据库设计、后端业务逻辑实现与前端交互的全流程，从而深化对‘系统’二字的理解。具体到应用场景，例如小区物业管理系统，就涉及业主信息、收费项目、服务工单等多个核心模块的CRUD操作与复杂业务逻辑处理。本文以Spring Boot和MyBatis-Plus这一高效组合为例，详细拆解了从环境搭建、ER图设计、到核心模块如收费管理（涉及事务与定时任务）的实现细节，为学习Java Web与数据库的同学提供了一个可直接复用的项目范本与避坑指南。

1. 项目概述与核心价值

最近在带学生做课设，发现很多同学拿到“小区物业管理系统”这个题目时，第一反应是去网上找源码，然后对着代码一通乱改，最后交上去一个自己都讲不清楚的“缝合怪”。这其实完全偏离了课程设计的初衷。今天，我就以一个过来人和指导老师的身份，和大家从头到尾拆解一遍这个经典课题。这个项目麻雀虽小，五脏俱全，它绝不仅仅是为了让你学会用Java连上MySQL做个增删改查（CRUD）那么简单。它真正的价值在于，让你在一个贴近真实业务场景的模型中，完整地走一遍软件开发的流程：从需求分析、数据库设计，到后端业务逻辑分层、前端交互，再到最后的测试部署。如果你能独立、清晰地完成它，你对“系统”二字的理解会上一个台阶，这远比背十道“Java八股文”面试题来得实在。

这个系统要解决的核心问题，是模拟一个中小型小区物业的日常信息化管理。想想你住的小区，物业要管什么？无非是这几大块：业主信息得登记吧（谁住哪栋哪单元）；物业费、水电费得收取和记录吧；报修投诉得有个渠道处理和跟踪吧；车位信息得管理吧；还有物业工作人员自己的排班和工单。把这些零散、手工的事务，通过一个系统串联起来，实现信息的集中存储、快速查询和流程化处理，就是我们要构建的东西。它适合正在学习Java Web和数据库课程的同学，也适合那些想找个完整项目练手、巩固MVC设计模式的朋友。下面，我就把整个项目的设计思路、技术选型、实现细节以及我踩过的坑，毫无保留地分享给你。

2. 整体架构设计与技术选型考量

2.1 为什么是Java + MySQL这个经典组合？

很多同学会问，现在Python、Go那么火，为什么课设还要用Java？原因很简单：教学意义和生态成熟度。Java是一门强类型、面向对象的语言，其严谨的语法结构非常有利于初学者建立良好的编程规范，理解封装、继承、多态这些核心概念。而小区物业管理系统恰恰是一个业务实体（如业主、房屋、费用）和关系都非常明确的场景，用Java的类（Class）来建模，再合适不过。例如，你可以定义一个Owner类，里面有id,name,phone,roomId等属性，这和数据库里的owner表几乎是一一对应的，这种“对象-关系映射”（ORM）的思想是后端开发的基石。

其次，Java Web的生态极其成熟。从基础的Servlet/JSP，到经典的SSH（Struts+Spring+Hibernate），再到如今主流的Spring Boot + MyBatis（或JPA），技术栈清晰，资料丰富。对于课设而言，我强烈推荐Spring Boot + MyBatis-Plus + Thymeleaf这个组合。Spring Boot能让你免去大量繁琐的XML配置，快速搭建一个可运行的Web应用；MyBatis-Plus是国内非常流行的ORM框架，它在MyBatis的基础上做了大量增强，单表CRUD几乎不用写SQL，能极大提升开发效率，让你更专注于业务逻辑；Thymeleaf是一个自然的模板引擎，语法简单，能与Spring Boot无缝集成，适合用来渲染后端数据生成动态页面。

至于数据库，MySQL是毫无争议的选择。它开源、免费、安装简单，社区活跃，是学习关系型数据库的最佳入门选择。物业系统的数据关系型特征非常明显：业主和房屋是一对一或一对多的关系，费用记录和业主是多对一的关系，这些用MySQL的外键（虽然生产环境慎用，但学习阶段可以理解其概念）、联合查询可以很好地表达。相比一些NoSQL数据库，MySQL在保证事务一致性（比如收费和更新余额必须同时成功或失败）方面有天然优势。

2.2 系统核心模块划分与ER图设计思路

动手写代码之前，一定要把系统模块和数据库表结构想清楚。这是最重要的一步，设计得好，后面编码顺风顺水；设计得差，后期改表结构能让你痛不欲生。根据物业核心业务，我们可以将系统划分为以下几个模块：

基础信息管理模块：核心中的核心。包括楼栋信息、房屋信息、业主信息。这里要注意房屋和业主的关系，一个房屋在不同时期可能有不同的业主（二手房），所以设计表时，房屋表应该有一个“当前业主ID”的字段，同时可能需要一个“业主历史关系表”来记录变更。
收费管理模块：包括物业费、水电费、停车费等各类费用的项目设置、生成账单、收费登记、欠费查询。这里涉及费用类型表、账单表和收费记录表。账单通常按月或按季度生成。
服务管理模块：包括业主报修、投诉建议的提交、分配、处理和回访。涉及工单表，状态流转（如：待受理、处理中、已完成、已评价）是设计关键。
车位管理模块：管理小区内车位信息（编号、类型、归属），以及车辆信息（车牌号、车主、绑定车位）。这里车位和车辆可能是一对一，也可能是一个业主有多辆车但只有一个固定车位。
系统管理模块：用户（物业员工）管理、角色权限管理、操作日志、系统公告等。

基于以上模块，我们来设计核心的实体关系图（ER图）。我强烈建议你使用工具（如Navicat的模型功能、在线工具draw.io，甚至纸笔）画出来。核心实体大概有7-8张表：

building(楼栋表)：id, 楼栋号, 总层数, 单元数...
room(房屋表)：id, 楼栋ID, 单元号, 房号, 面积, 当前业主ID...
owner(业主表)：id, 姓名, 身份证号, 联系电话, 入住时间...
fee_item(收费项目表)：id, 项目名称(如“物业费”、“水费”), 单价, 计费单位(如“元/平米/月”、“元/吨”), 收费周期...
fee_bill(账单表)：id, 房屋ID, 费用项目ID, 计费期间(如“2024-01”), 应缴金额, 缴费状态(未缴/部分缴/已缴), 生成时间...
payment_record(缴费记录表)：id, 账单ID, 实缴金额, 支付方式, 缴费时间, 操作员...
repair_complaint(报修投诉表)：id, 业主ID, 类型(报修/投诉), 标题, 内容, 提交时间, 状态, 处理人, 处理结果, 完成时间...
parking(车位表)：id, 车位编号, 类型(固定/临时), 绑定房屋ID...
car(车辆表)：id, 车牌号, 车主ID, 绑定车位ID...
sys_user(系统用户表)：id, 用户名, 密码(加密存储!), 真实姓名, 角色...
sys_role(角色表)：id, 角色名...
sys_menu(菜单权限表)：id, 菜单名, 权限标识...

注意：在实际设计中，密码字段务必使用BCryptPasswordEncoder等工具进行哈希加密后存储，明文存储是严重的安全事故。角色权限设计可以根据课设复杂度简化，比如只分“管理员”和“普通员工”两种角色，通过硬编码判断。

画ER图时，重点思考实体间的关联关系，并用外键（Foreign Key）在逻辑上体现出来。例如，room表的building_id关联building.id，fee_bill表的room_id关联room.id。虽然在实际开发中，特别是使用MyBatis-Plus时，我们可能不强制在数据库层面建立外键约束（为了性能和解耦），但在设计阶段，这个概念必须清晰。

3. 开发环境搭建与项目初始化

3.1 一站式环境配置清单与避坑指南

工欲善其事，必先利其器。一个顺畅的环境能避免很多莫名其妙的错误。

JDK：安装JDK 8或JDK 11（LTS长期支持版本）。推荐JDK 11，对后续技术栈兼容性更好。安装后务必配置JAVA_HOME环境变量，并确保java -version命令能正确输出。
实操心得：很多同学JAVA_HOME配错了，指向了jdk目录下的bin文件夹，这是不对的。JAVA_HOME应该指向jdk的根目录，例如C:\Program Files\Java\jdk-11.0.xx。Path变量里添加%JAVA_HOME%\bin。
Maven：用于管理项目依赖。去官网下载，解压，配置MAVEN_HOME和Path。安装后运行mvn -v测试。
避坑技巧：国内使用Maven，一定要配置阿里云镜像。修改conf/settings.xml文件，在<mirrors>标签内添加阿里云镜像配置，否则下载依赖会慢到怀疑人生。
MySQL：推荐安装MySQL 5.7或8.0。安装过程中记住你设置的root密码。安装完成后，建议使用图形化工具如Navicat、MySQL Workbench或DBeaver来连接和管理数据库，比命令行高效直观得多。
常见问题：安装后无法连接？检查MySQL服务是否启动（Windows服务里找MySQL），检查是否开启了防火墙阻止了3306端口。使用Navicat连接时，如果MySQL是8.0版本，可能因为密码加密方式（caching_sha2_password）导致旧版客户端连接失败，可以在安装时选择传统加密方式，或者用命令ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的新密码';来修改。
IDE：IntelliJ IDEA（社区版免费）是Java开发的不二之选，对Spring Boot支持极好。Eclipse也可以，但IDEA在智能提示、代码分析和集成度上更胜一筹。

3.2 使用Spring Initializr快速构建项目骨架

现在开始创建项目。打开IDEA，选择New Project->Spring Initializr。

Project Metadata：
- Group:com.property(通常用公司或组织域名倒写)
- Artifact:property-management
- Type:Maven
- Java Version: 选择你安装的版本（如11）
- Packaging:Jar(Spring Boot推荐，内置Tomcat，打包即运行)
Dependencies：这是关键步骤，勾选我们需要的起步依赖：
- Spring Web(用于构建Web MVC)
- Thymeleaf(模板引擎)
- MyBatis Framework或直接搜索MyBatis-Plus(如果Initializr列表里有，选它；没有就后面在pom.xml里手动加)
- MySQL Driver(数据库驱动)
- Lombok(强烈推荐！通过注解自动生成Getter/Setter等方法，让实体类代码非常简洁)

点击创建，IDEA会自动下载依赖并生成项目。等待初始化完成，一个标准的Spring Boot项目结构就出来了：src/main/java放Java代码，src/main/resources放配置文件，src/test放测试代码。

3.3 关键配置文件详解与数据库连接

项目创建后，首先配置数据库连接。打开src/main/resources/application.properties文件（或者新建application.yml，我更喜欢yml的层次结构），进行如下配置：

# 应用服务器端口 server: port: 8080 # 数据源配置 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/property_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 你的密码 # Thymeleaf配置 (关闭缓存，开发时修改模板立即生效) thymeleaf: cache: false mode: HTML encoding: UTF-8 # MyBatis-Plus 配置 mybatis-plus: configuration: # 控制台打印SQL日志，调试时非常有用 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: # 全局逻辑删除字段名（若需要软删除功能） logic-delete-field: isDeleted logic-delete-value: 1 logic-not-delete-value: 0 # 指定mapper.xml文件位置，如果用了注解方式，可以不用 mapper-locations: classpath:mapper/*.xml

重要提示：url中的serverTimezone=Asia/Shanghai必须设置，否则可能遇到时区错误。useSSL=false在本地开发环境可以关闭SSL以简化连接。

接着，在MySQL中用Navicat或命令行创建一个名为property_db的数据库，字符集选utf8mb4（支持存储Emoji等特殊字符）。配置好后，启动项目主类（带有@SpringBootApplication注解的类），如果控制台没有报错，看到Tomcat started on port(s): 8080，说明基础环境搭建成功。

4. 核心业务模块实现详解

4.1 实体类、Mapper与Service层的标准写法

我们以最核心的业主(Owner)模块为例，展示三层架构的代码组织。首先，在com.property.entity包下创建实体类Owner.java。

package com.property.entity; import com.baomidou.mybatisplus.annotation.IdType; import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; import java.util.Date; @Data @TableName("owner") // 指定对应数据库表名 public class Owner { @TableId(type = IdType.AUTO) // 主键自增 private Long id; private String name; private String idCard; // 身份证号 private String phone; private Long roomId; // 当前居住房屋ID private Date checkInDate; // 入住日期 private String emergencyContact; // 紧急联系人 private String emergencyPhone; // 可以添加逻辑删除字段 // private Integer isDeleted; }

@Data是Lombok注解，自动生成getter, setter, toString等方法。@TableName和@TableId是MyBatis-Plus的注解。

接着，创建Mapper接口。在com.property.mapper包下创建OwnerMapper.java。

package com.property.mapper; import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.property.entity.Owner; import org.apache.ibatis.annotations.Mapper; @Mapper // 标记为MyBatis的Mapper，Spring会自动扫描 public interface OwnerMapper extends BaseMapper<Owner> { // 继承BaseMapper后，基本的CRUD方法都有了。 // 如果需要复杂查询，可以在这里定义方法，并在对应的OwnerMapper.xml中写SQL }

继承BaseMapper<Owner>是关键，它为你提供了insert,selectById,updateById,deleteById,selectList等大量通用方法，无需编写任何SQL。

然后，创建Service层。先创建接口IOwnerService在com.property.service包下，再创建实现类。

// IOwnerService.java package com.property.service; import com.baomidou.mybatisplus.extension.service.IService; import com.property.entity.Owner; public interface IOwnerService extends IService<Owner> { // 可以在此定义一些特殊的业务方法，比如“根据姓名模糊查询” // Page<Owner> selectPageByName(Page<Owner> page, String name); } // OwnerServiceImpl.java package com.property.service.impl; import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; import com.property.entity.Owner; import com.property.mapper.OwnerMapper; import com.property.service.IOwnerService; import org.springframework.stereotype.Service; @Service // 标记为Spring的Service组件 public class OwnerServiceImpl extends ServiceImpl<OwnerMapper, Owner> implements IOwnerService { // 如果IOwnerService有自定义方法，在这里实现 // 否则，继承ServiceImpl已经获得了所有基础CRUD能力 }

最后是Controller层，在com.property.controller包下创建OwnerController.java。

package com.property.controller; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.baomidou.mybatisplus.core.metadata.IPage; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.property.entity.Owner; import com.property.service.IOwnerService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.*; @Controller @RequestMapping("/owner") public class OwnerController { @Autowired private IOwnerService ownerService; // 分页查询业主列表 @GetMapping("/list") public String list(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, @RequestParam(required = false) String name, Model model) { Page<Owner> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<Owner> wrapper = new LambdaQueryWrapper<>(); if (name != null && !name.trim().isEmpty()) { wrapper.like(Owner::getName, name); // 模糊查询姓名 } wrapper.orderByDesc(Owner::getId); // 按ID倒序 IPage<Owner> ownerPage = ownerService.page(page, wrapper); model.addAttribute("pageData", ownerPage); model.addAttribute("name", name); return "owner/list"; // 对应 src/main/resources/templates/owner/list.html } // 跳转到新增页面 @GetMapping("/add") public String toAdd() { return "owner/add"; } // 执行新增操作 @PostMapping("/add") public String add(Owner owner) { ownerService.save(owner); return "redirect:/owner/list"; // 重定向到列表页 } // 跳转到编辑页面 @GetMapping("/edit/{id}") public String toEdit(@PathVariable Long id, Model model) { Owner owner = ownerService.getById(id); model.addAttribute("owner", owner); return "owner/edit"; } // 执行更新操作 @PostMapping("/update") public String update(Owner owner) { ownerService.updateById(owner); return "redirect:/owner/list"; } // 删除操作 @GetMapping("/delete/{id}") public String delete(@PathVariable Long id) { ownerService.removeById(id); return "redirect:/owner/list"; } }

这就是一个完整的、基于MyBatis-Plus的CRUD模块的代码结构。你会发现，我们几乎没有写SQL，所有基础操作都通过继承和调用现成的方法完成了，这就是现代Java开发的效率。

4.2 复杂业务逻辑：费用生成与缴费流程实现

收费模块是业务逻辑的亮点。它涉及到定时任务、事务管理和状态更新。假设我们每月1号自动生成所有房屋的物业费账单。

首先，创建FeeBill（账单）实体，它关联房屋和收费项目。然后，我们需要一个定时任务。Spring Boot通过@Scheduled注解支持定时任务。

启用定时任务：在主应用类或配置类上添加@EnableScheduling注解。
编写任务类：在com.property.task包下创建FeeGenerateTask.java。

package com.property.task; import com.property.entity.FeeBill; import com.property.entity.Room; import com.property.service.IFeeBillService; import com.property.service.IRoomService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; import org.springframework.transaction.annotation.Transactional; import java.math.BigDecimal; import java.time.LocalDate; import java.time.format.DateTimeFormatter; import java.util.List; @Component public class FeeGenerateTask { @Autowired private IRoomService roomService; @Autowired private IFeeBillService feeBillService; // 每月1号凌晨1点执行 (cron表达式) @Scheduled(cron = "0 0 1 1 * ?") @Transactional(rollbackFor = Exception.class) // 添加事务，确保数据一致性 public void generateMonthlyPropertyFee() { // 1. 获取所有需要生成账单的房屋（例如，状态为“已入住”的） List<Room> rooms = roomService.list(); // 这里应加查询条件，简化示例 String period = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy-MM")); // 当前年月作为计费期间 for (Room room : rooms) { // 2. 计算应缴金额 (假设物业费单价为2元/平米/月) BigDecimal unitPrice = new BigDecimal("2.00"); BigDecimal area = new BigDecimal(room.getArea().toString()); BigDecimal amount = unitPrice.multiply(area); // 3. 创建账单对象 FeeBill bill = new FeeBill(); bill.setRoomId(room.getId()); bill.setFeeItemId(1L); // 假设物业费的项目ID是1 bill.setBillingPeriod(period); bill.setAmountDue(amount); bill.setStatus(0); // 0-未缴 bill.setRemark("系统自动生成"); // 4. 检查是否已存在该房屋该周期的账单，避免重复生成 // 这里需要调用一个自定义的检查方法，示例略 // if (!feeBillService.exists(bill)) { feeBillService.save(bill); // } } System.out.println("[" + period + "]物业费账单生成完成，共生成" + rooms.size() + "条。"); } }

缴费流程在Controller中实现，关键是要处理部分缴费和更新账单状态。

// 在PaymentController中 @PostMapping("/pay") @Transactional(rollbackFor = Exception.class) public String pay(@RequestParam Long billId, @RequestParam BigDecimal paidAmount, @RequestParam String paymentMethod) { FeeBill bill = feeBillService.getById(billId); if (bill == null || bill.getStatus() == 2) { // 2-已缴清 throw new RuntimeException("账单不存在或已缴清"); } // 1. 创建缴费记录 PaymentRecord record = new PaymentRecord(); record.setBillId(billId); record.setPaidAmount(paidAmount); record.setPaymentMethod(paymentMethod); record.setPaymentTime(new Date()); record.setOperator(getCurrentUser()); // 获取当前登录用户 paymentRecordService.save(record); // 2. 更新账单状态和已缴金额 BigDecimal alreadyPaid = bill.getAmountPaid() != null ? bill.getAmountPaid() : BigDecimal.ZERO; BigDecimal newPaidTotal = alreadyPaid.add(paidAmount); bill.setAmountPaid(newPaidTotal); // 判断是否缴清 if (newPaidTotal.compareTo(bill.getAmountDue()) >= 0) { bill.setStatus(2); // 已缴清 bill.setPaidTime(new Date()); } else if (newPaidTotal.compareTo(BigDecimal.ZERO) > 0) { bill.setStatus(1); // 部分缴纳 } feeBillService.updateById(bill); // 3. (可选) 更新业主的欠费总览等信息 // ... return "redirect:/fee/bill/list"; }

注意事项：金融计算一定要用BigDecimal，绝对不能用double或float，否则会有精度丢失问题。@Transactional注解确保了缴费记录和账单状态更新是一个原子操作，要么都成功，要么都失败回滚。

4.3 前端页面与Thymeleaf模板整合

后端逻辑完成后，需要前端页面来展示和交互。我们在src/main/resources/templates下创建对应的HTML文件。以业主列表页owner/list.html为例：

<!DOCTYPE html> <html lang="zh" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>业主信息管理</title> <!-- 引入Bootstrap CSS --> <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet"> </head> <body> <div class="container-fluid mt-3"> <h2>业主信息列表</h2> <!-- 搜索框 --> <form class="row g-2 mb-3" th:action="@{/owner/list}" method="get"> <div class="col-auto"> <input type="text" class="form-control" name="name" th:value="${name}" placeholder="输入业主姓名"> </div> <div class="col-auto"> <button type="submit" class="btn btn-primary">查询</button> <a th:href="@{/owner/list}" class="btn btn-secondary">重置</a> </div> <div class="col-auto ms-auto"> <a th:href="@{/owner/add}" class="btn btn-success">新增业主</a> </div> </form> <!-- 数据表格 --> <table class="table table-bordered table-hover"> <thead class="table-light"> <tr> <th>ID</th> <th>姓名</th> <th>身份证号</th> <th>电话</th> <th>房屋号</th> <th>操作</th> </tr> </thead> <tbody> <!-- Thymeleaf循环渲染数据 --> <tr th:each="owner : ${pageData.records}"> <td th:text="${owner.id}"></td> <td th:text="${owner.name}"></td> <td th:text="${owner.idCard}"></td> <td th:text="${owner.phone}"></td> <td th:text="${owner.roomId}"></td> <td> <a th:href="@{/owner/edit/{id}(id=${owner.id})}" class="btn btn-sm btn-warning">编辑</a> <a th:href="@{/owner/delete/{id}(id=${owner.id})}" class="btn btn-sm btn-danger" onclick="return confirm('确定删除吗？')">删除</a> </td> </tr> </tbody> </table> <!-- 分页组件 --> <nav> <ul class="pagination justify-content-center"> <li class="page-item" th:classappend="${pageData.current == 1} ? 'disabled' : ''"> <a class="page-link" th:href="@{/owner/list(pageNum=${pageData.current-1}, pageSize=${pageData.size}, name=${name})}">上一页</a> </li> <!-- 简化分页，实际应循环页码 --> <li class="page-item" th:each="i : ${#numbers.sequence(1, pageData.pages)}" th:classappend="${i == pageData.current} ? 'active' : ''"> <a class="page-link" th:href="@{/owner/list(pageNum=${i}, pageSize=${pageData.size}, name=${name})}" th:text="${i}"></a> </li> <li class="page-item" th:classappend="${pageData.current == pageData.pages} ? 'disabled' : ''"> <a class="page-link" th:href="@{/owner/list(pageNum=${pageData.current+1}, pageSize=${pageData.size}, name=${name})}">下一页</a> </li> </ul> <div class="text-center"> 共 <span th:text="${pageData.total}"></span> 条记录， 第 <span th:text="${pageData.current}"></span> 页 / 共 <span th:text="${pageData.pages}"></span> 页 </div> </nav> </div> <!-- 引入Bootstrap JS --> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/js/bootstrap.bundle.min.js"></script> </body> </html>

Thymeleaf的语法th:*允许你在HTML中直接使用后端传来的变量（如${pageData.records}）和控制逻辑（如th:each,th:if）。th:href可以动态生成URL。这样，一个带有搜索、分页、增删改查功能的列表页就完成了。新增和编辑页面的表单，也是类似的原理，使用th:object和th:field来绑定数据对象。

5. 项目调试、部署与课设报告要点

5.1 开发中的常见问题与调试技巧

数据库连接失败：
- 错误信息：Communications link failure或Access denied for user。
- 排查：检查application.yml中的url,username,password是否正确；检查MySQL服务是否启动；检查防火墙是否开放3306端口；对于MySQL 8.0，检查连接驱动版本和密码加密插件是否匹配。
MyBatis-Plus 插入/更新时字段为null：
- 现象：实体类有值，但插入数据库后某些字段为null。
- 原因：数据库表字段名和实体类属性名不一致（例如表字段user_name，实体属性userName），MyBatis-Plus默认使用驼峰转下划线映射，如果不符合这个规则，需要用@TableField注解指定。
```
@TableField("user_name") // 指定数据库字段名 private String userName;
```
Thymeleaf 模板解析错误：
- 现象：页面报错，提示模板不存在或变量找不到。
- 排查：检查Controller中返回的字符串路径是否正确，是否在templates目录下；检查页面中使用的Thymeleaf变量名是否和Model中addAttribute的key一致；检查是否引入了xmlns:th="http://www.thymeleaf.org"。
事务不生效：
- 现象：方法加了@Transactional，但抛出异常后数据还是被修改了。
- 排查：确保异常被抛出且未被捕获；确保方法是public的（Spring AOP代理要求）；确保调用方是通过Spring代理对象调用的该方法（即，在同一个Service类中，一个非事务方法A调用同一个类的事务方法B，B的事务会失效）。

调试利器：

控制台SQL日志：在配置文件中开启mybatis-plus.configuration.log-impl，可以清晰看到MyBatis-Plus执行的每一条SQL，方便排查数据问题。
Postman或浏览器开发者工具：测试API接口，查看请求参数和响应结果。
IDEA的Debug模式：打断点，逐步执行，查看变量值，是定位复杂逻辑问题的终极武器。

5.2 项目打包与简易部署

开发完成后，需要打包成可运行的Jar文件。在项目根目录下（包含pom.xml的目录）打开终端，运行Maven命令：

mvn clean package

如果一切顺利，会在target目录下生成一个property-management-0.0.1-SNAPSHOT.jar文件。这个文件是“可执行Jar”，它内嵌了Tomcat服务器。部署极其简单，只需要服务器上有Java运行环境（JRE）。

将Jar包上传到服务器（如一台云主机或本地虚拟机），在Jar包所在目录执行：

java -jar property-management-0.0.1-SNAPSHOT.jar

应用就会在后台启动，监听你在application.yml中配置的端口（默认8080）。你可以通过nohup java -jar ... &命令让它在后台持续运行。更生产化的部署会使用Docker容器或配合Nginx做反向代理，但对于课设演示和报告，直接运行Jar包已经足够。

5.3 课设报告与答辩核心要点

一份优秀的课设报告和清晰的答辩，能为你加分不少。报告不应是代码的堆砌，而应体现你的思考和设计。

报告结构建议：
1. 绪论：简述项目背景（小区物业管理信息化需求）、目的和意义。
2. 需求分析：用文字或用例图描述系统的功能需求（业主管理、收费管理等）和非功能需求（界面友好、响应快速等）。
3. 系统设计：这是重点。
  - 总体设计：系统架构图（展示前端、后端、数据库的层次关系）。
  - 功能模块设计：用框图说明各个模块及其关系。
  - 数据库设计：给出完整的ER图，并附上核心数据表的结构说明（表名、字段名、类型、说明、约束），这是评委重点看的地方。
4. 系统实现：挑选2-3个有代表性的功能模块（如业主管理的CRUD、收费生成逻辑），展示关键代码片段（如Controller、Service方法、SQL语句或MyBatis-Plus的使用），并配上界面截图。
5. 系统测试：描述测试环境，列出主要功能的测试用例和结果（可以做成表格）。
6. 总结与展望：总结项目完成情况、遇到的难点及解决方法、收获体会，并提出系统可以改进的地方（如增加移动端、接入在线支付、数据分析报表等）。
答辩准备：
- 演示流程：准备一个5-10分钟的演示脚本，从登录开始，流畅地展示核心功能（增删改查、生成账单、缴费）。
- 突出重点：不要面面俱到，重点讲你的数据库设计思路（为什么这样建表？）、技术选型理由（为什么用MyBatis-Plus？）、解决的1-2个技术难点（比如事务处理、分页查询）。
- 准备问答：提前思考老师可能问的问题，例如：“你的表之间是怎么关联的？”“如果业主换了房子，你的数据怎么处理？”“定时任务是怎么实现的？”“如何保证缴费时数据的一致性？”
- 展示代码：对关键代码要熟悉，能快速在IDE中找到并解释。