简介面向小程序毕业设计与课程设计场景这份小区物业管理系统源码包将微信小程序前端与 Java 后端形成完整项目。业主端覆盖报修管理、缴欠费查询、房屋与业主信息查询管理员端覆盖权限、报修、缴欠费、房屋与业主信息管理共九大模块便于直接移植或二次扩展。环境要求 JDK1.8、MySQL5.7 及以上小程序端支持 uniapp 或原生微信小程序配套文档齐全。包体共 405 个文件压缩后约 47.02MB核心类型包括 wxml/wxss 页面与样式、java 业务逻辑、js 逻辑与 json 配置、sql 数据库脚本、doc/docx 设计说明及 avi 操作演示录屏目录清晰便于按模块查找目前已有 58 人学习/下载。读者可获得前后端源码、数据库初始化脚本、说明文档与演示视频既能快速跑通系统流程也可参考模块划分撰写毕业设计论文对需要完成课程设计或毕业设计的计算机专业学生尤为实用。1. 一份小区物业管理系统源码毕业设计为什么绕不开它小程序毕业设计选来选去最后还是落到“小区物业管理系统”上的学生非常多。原因很直接这个业务不需要懂物流、金融、电商那些复杂领域业主端做报修、缴费、公告物业端做工单处理、费用管理、后台统计功能边界清晰前后端和 MySQL 都能覆盖到答辩时也容易讲明白。标题里“完整前后端mysql说明文档LW”这套交付物意味着你拿到的不是一段半成品——小程序端、管理端、数据库脚本、说明文档和论文材料是齐的。适合两类人一类是时间紧、想快速跑通并理解一套可靠全栈模板的毕业生另一类是刚学完 Spring Boot 和微信小程序想找一个完整项目练手、知道每层代码该放哪的初学者。2. 拆系统模块、数据表和选型先把地基打好拿到一份源码先别急着跑第一步是把它的骨架拆明白。很多人在本地起服务时一脸懵就是因为不知道哪个表对应哪个页面、哪个接口叫什么名字。下面按照“页面模块 → 数据库表 → 框架选型”的顺序把系统拆开看。2.1 模块怎么分业主端与物业端各要什么页面常见做法是把系统拆成两个端业主端跑在微信小程序里物业端跑在 Web 管理后台里。双方操作同一个 MySQL 数据库只是入口不同。业主端小程序通常围绕“住”这个场景展开核心页面就四个。首页展示物业公告和缴费提醒报修页面提交家里的漏水、电路、门禁故障上传图片和描述缴费页面查看水电物业费账单并模拟支付我的页面展示住户信息、报修记录和缴费历史。支付环节在毕设里一般不做真实微信支付用一个“模拟已支付”按钮带过这是答辩可以接受的简化要在论文里写清楚。物业端管理后台则走反向流程登录后进入工单列表处理业主报修并回填处理状态发布和下线公告录入每户的月度费用账单查看小区房屋与业主信息。如果选题再扩展一点还可以加车位管理、访客登记但毕设不建议贪多把上面这些跑通已经能支撑一个完整答辩。这两个端的数据流向也很清晰小程序端通过 ajax 请求调用后端 controller 层接口后端 service 层处理业务mapper 层操作 MySQL结果沿原路返回小程序再刷新页面。理解了这条链路后面所有代码都能对号入座。2.2 MySQL 表设计五张核心表与关键字段打开源码里的 sql 目录初始化脚本一般会建 six 到八张表但核心是下面五张管理员表、业主表、报修表、缴费表和公告表。表设计是答辩常被追问的点下面把每张表的关键字段列出来。管理员表 admin_user 存后台登录账号字段包括 id、username、password、real_name、create_time。password 注意看源码里是明文还是 MD5 加密如果论文里写“系统做了安全防护”那这里至少得是 MD5 加盐。业主表 owner_user 对应小程序端用户字段有 id、room_no房号、name、phone、password、create_time。room_no 常被用来做登录账号比如输入 3-1202 加手机号登录这种设计比自增 id 更贴近真实场景。报修表 repair_order 是业务核心字段包括 id、owner_id、type报修类型、description、image_url、status、create_time、handle_time。status 是整个系统的关键一般用整数表示0 待受理、1 处理中、2 已完成、3 已驳回。答辩时老师很喜欢问“状态流转怎么实现的”答案就在这个字段上前端按钮根据 status 不同显示不同操作。缴费表 fee_record 字段有 id、owner_id、fee_type物业费、水费、电费、amount、pay_status、due_time、pay_time。pay_status 用 0 未缴 1 已缴首页的缴费提醒就是查 pay_status 0 的记录。公告表 notice 最简单id、title、content、create_time 四列就够发布公告页面 insert 一条首页查最近五条展示。表之间用外键还是不用的老问题也会被问到。我的建议是逻辑外键代替物理外键。代码里用 owner_id 关联但不在数据库层面建 FOREIGN KEY理由是毕设项目数据量小物理外键不影响性能但会在删除演示数据时带来一堆约束报错演示翻车了反而扣分。这个取舍可以在论文里写一段显得你有工程判断力。2.3 框架选型Spring Boot 原生小程序还是 uni-app 一套多端前端选型是这套毕设里最常见的纠结。标题写的是“小程序”具体是原生微信小程序还是 uni-app源码打开看了就知道。但站在你自己做毕设的角度我建议优先选原生微信小程序加 Spring Boot 的组合。理由有三条。第一原生小程序和微信开发者工具配合没有中间层调试报错信息直接不像 uni-app 在某些版本上编译后的小程序端有不一致表现。第二答辩现场通常要投屏演示原生小程序打开即用不用先跑 HBuilderX 再编译。第三网上“微信小程序毕业设计”的资料密度远高于 uni-app你卡住时搜到答案的概率更大。后端框架同理Spring Boot 是目前绝对主流MyBatis-Plus 比原生 MyBatis 少写大量 XML单表 CRUD 甚至不用写 SQL对赶进度的毕业生很友好。MySQL 用 8.0 就好5.7 的安装和驱动写法略旧新踩的坑反而多。下面是一份典型的后端配置文件先开个眼下一章我们在它基础上跑通最小闭环。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/property_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath:mapper/**/*.xml configuration: map-underscore-to-camel-case: true这里有几个坑提前说。url 里的 characterEncodingutf8 必须加上否则中文公告和报修描述入库变问号serverTimezoneAsia/Shanghai 不配的话MySQL 驱动会按 UTC 读取时间录入的数据在页面上差 8 小时这个下一章第 4 节还会再遇到。map-underscore-to-camel-case 是让数据库的 create_time 自动映射到 Java 的 createTime少写一堆手动物理映射这个开关建议保持开启。3. 本地跑通前后端从环境准备到一次完整报修闭环这一章的目标很明确让你在 30 分钟内看到登录页能进、公告能刷、报修能提交成功。前面无论选什么框架这一步的路径是通用的只是命令和目录名可能有差异按你自己的源码结构对照着改。3.1 环境清单JDK、Maven、MySQL 8、微信开发者工具先列一个环境清单对照你机器上已有的再动手。JDK 建议 1.8 或 11Spring Boot 2.x 系列在这两个版本上都稳定如果你源码用的是 Spring Boot 3那 JDK 得升到 17。版本不对最常见的现象是启动直接抛 UnsupportedClassVersionError看到它先查 JDK 而不是查代码。Maven 用 3.6.3 以上版本即可它负责拉取 Spring Boot、MyBatis-Plus 这些依赖。MySQL 用 8.0安装时要记好 root 密码并在初始化脚本里确认数据库名。微信开发者工具用来跑小程序端安装后需要你注册一个个人小程序账号申请一个 AppID没有 AppID 可以用测试号但测试号不支持部分云能力仅本地调试是够的。数据库初始化这步最容易出错进 Navicat 或命令行执行脚本前先手动建一个空库mysql -uroot -p123456 -e CREATE DATABASE IF NOT EXISTS property_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p123456 --default-character-setutf8mb4 property_db sql/property_db.sql参数说明-u 后跟用户名-p 后跟密码数据库名 property_db 要和后端 application.yml 里的 url 路径一致否则后面启动提示 Unknown database。--default-character-setutf8mb4 是为了让中文表数据在导入时不乱码这是 MySQL 8 命令行导入最容易被忽略的一个参数。导入完成后用 show tables 看到那几张核心表就说明数据层准备好了。3.2 后端工程结构Controller、Service、Mapper 三层的组织方式打开后端源码目录标准 Maven 工程应该是这样的结构如果你手里的组织方式略有不同只要分层思路一致就没问题property-server/ ├── pom.xml ├── src/main/java/com/example/property/ │ ├── PropertyApplication.java │ ├── controller/ │ │ ├── AuthController.java │ │ ├── RepairController.java │ │ └── NoticeController.java │ ├── service/ │ │ ├── OwnerService.java │ │ ├── RepairService.java │ │ └── FeeService.java │ ├── mapper/ │ │ ├── OwnerMapper.java │ │ ├── RepairMapper.java │ │ └── FeeMapper.java │ └── entity/ │ ├── Owner.java │ ├── RepairOrder.java │ └── Notice.java ├── src/main/resources/ │ ├── application.yml │ └── mapper/ └── sql/ └── property_db.sqlController 层只做两件事接收前端请求参数、返回统一结构给前端。业务判断全部下放到 Service。Mapper 层继承 MyBatis-Plus 的 BaseMapper 后insert、selectById、updateById 这些单表操作直接就有不需要自己写 SQL。判断源码靠不靠谱的一个小技巧是看 Service 层有没有厚度如果 Controller 里直接调 mapper查完直接返回说明这套代码只做了增删改查答辩时老师深入问两句就容易露怯。启动后端前先确认 8080 端口没被占用然后在项目根目录执行mvn spring-boot:run看到 “Started PropertyApplication” 日志后浏览器访问 http://localhost:8080/api/notice/list如果返回一串 JSON 公告数据后端就是通的。如果启动报数据库连接失败回头检查 application.yml 里的数据库名、用户名、密码这三项这个排错在第 4 章细说。3.3 登录接口与小程序的 wx.login 对接小程序端登录是前后端联动最典型的场景。常见做法是先调 wx.login 获取一个临时 code再用 code 去后端换取自己系统的业务凭证。但毕设项目里我建议换个更稳的路子直接用账号密码登录用户名存房号或手机号后端校验后返回一个 token 给小程序存起来。原因很现实微信 code2session 需要配置 AppSecret而且 code 换 openid 的接口在开发工具和真机上都有不少玄学问题答辩现场演示失败的概率不低。用账号密码登录只要数据库里有这条业主记录就能进演示掌控度更高。后端的登录接口大致长这样RestController RequestMapping(/api/auth) public class AuthController { private final OwnerService ownerService; public AuthController(OwnerService ownerService) { this.ownerService ownerService; } PostMapping(/login) public Result login(RequestBody LoginRequest req) { Owner owner ownerService.lambdaQuery() .eq(Owner::getPhone, req.getPhone()) .one(); if (owner null || !owner.getPassword().equals(req.getPassword())) { return Result.error(账号或密码错误); } String token UUID.randomUUID().toString().replace(-, ); return Result.success(token); } }login 方法先通过手机号查业主记录再比对密码这里没有做加密是简化演示用的真实项目密码必须走 MD5 加盐或 BCrypt论文里要嘴上承认“生产环境应升级”。token 生成比较粗暴直接 UUID够用但不可扩展第 5 章会给一个 JWT 的更正规做法。小程序端 app.js 里这样对接登录态App({ onLaunch() { const token wx.getStorageSync(token) if (!token) { this.login() } }, login() { wx.request({ url: http://127.0.0.1:8080/api/auth/login, method: POST, data: { phone: 13800000000, password: 123456 }, success: (res) { wx.setStorageSync(token, res.data.data) } }) } })代码里故意写死了演示账号你可以改成从登录页表单里读取。wx.setStorageSync 把 token 存到本地缓存之后每次请求在 header 里带上它后端就能识别当前用户。注意 url 用了 127.0.0.1 而不是 localhost原因是某些 Windows 环境下 localhost 会被解析成 IPv6 ::1后端只监听 IPv4 时请求就失败。3.4 提交一条报修单前端表单到后端落库的完整路径跑通闭台最快的方式是走一遍报修流程小程序填报修单后端落库物业后台看到未处理记录处理后再回到小程序列表。先看后端提交接口PostMapping(/submit) public Result submit(RequestBody RepairOrder order) { order.setStatus(0); // 新提交默认待受理 order.setCreateTime(LocalDateTime.now()); // 补全创建时间 repairService.save(order); return Result.success(order.getId()); }前端小程序的提交代码如下submitRepair() { const that this wx.request({ url: http://127.0.0.1:8080/api/repair/submit, method: POST, header: { token: wx.getStorageSync(token) }, data: { type: this.data.type, description: this.data.description, imageUrl: this.data.imageUrl, ownerId: this.data.ownerId }, success(res) { if (res.data.code 200) { wx.showToast({ title: 提交成功 }) that.loadRepairList() } } }) }这段逻辑里有关键一点值得在答辩时主动提后端没有信任前端传的 ownerId而是应该从 token 去解析当前登录用户这个安全思路会在第 5 章用 JWT 修正。前端只负责采集信息和展示结果业务判断必须留在后端这是我做这类项目反复强调的一道原则。刚提交的报修单在列表页是看不到完成的因为 status 还是 0。你可以直接改数据库把这条记录的 status 改成 2也可以在管理后台点一下“处理完成”按钮后者更符合演示逻辑。完整闭环跑通后你会对“小程序发起请求 → 后端处理 → 数据库落库 → 再查出来展示”这条链路有切身感觉后面答辩被问“前后端怎么交互”时就用这条报修链路讲比背概念清楚得多。4. 小区物业管理系统避坑指南5 个翻车点与排错方法这一章是血泪经验部分。下面 5 个问题是我见过几乎每个跑这套系统的人都会撞上的按出现频率从高到低排每条都按“现象 → 原因 → 解决”写清楚。4.1 MySQL 连不上ERROR 2003 和 Access denied 怎么定位后端启动时最常见的就是两个错误。一个是 Cant connect to MySQL server on localhost (10061) 或 ERROR 2003 (HY000)意思是网络层没连上 MySQL 服务。先检查 MySQL 服务是否启动Windows 在服务管理器里看 MySQL80 是否在运行Linux 执行 systemctl status mysqld没启动就用 systemctl start mysqld。另一个是 Access denied for user rootlocalhost说明账号密码不对。用命令行敲 mysql -uroot -p你的密码 试一下能进数据库就排除 MySQL 本身问题再回来核对 application.yml 里的密码。端口 3306 被占也常发生换机后第一次启动时提示端口占用多半是之前装过别的 MySQL 实例改端口或用 Navicat 连一下看看哪个实例在跑。4.2 小程序 request 一直 fail本地调试时先关掉域名校验小程序发请求给 http://127.0.0.1:8080 大概率会 fail报 url not in domain list。微信小程序对网络请求有域名白名单限制正式发布必须使用备案过的 HTTPS 域名但本地调试不用。解决方法在微信开发者工具右上角“详情 → 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”勾完重新编译立即生效。这个操作在答辩现场也常被问到直接回答“本地开发阶段关闭域名校验线上部署时会配 HTTPS 正式域名”再加一句“内置了域名配置常量切换环境只需要改一个变量”这就叫有工程意识老师不会追问过深。注意如果用了真机预览手机和电脑要连同一个局域网且 url 改成电脑的局域网 IP127.0.0.1 在手机上指向手机自身这个细节能省你半小时。4.3 时间字段差 8 小时JSON 序列化与 JDBC 时区配置列表页显示报修时间总比录入时间早 8 小时最常见的原因是 JDBC 连接没指定时区。MySQL 8 驱动默认用服务器时区如果服务器设成 UTCJava 这边转出来就是 UTC 时间显示成北京就少了 8 小时。解决方法是 application.yml 里 url 加 serverTimezoneAsia/Shanghai同时实体类的 LocalDateTime 字段加一个 Jackson 配置保证 JSON 输出格式统一JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8) private LocalDateTime createTime;这个注解的作用是告诉 Jackson 序列化时用哪个时区和格式不写的话返回给小程序的是数组形式的日期结构前端解析反而更费劲。时间问题排查时先看数据库原始时间对不对库里的值对就是后端转换问题库里都不对就是录入端问题按这个顺序查最省力。4.4 上传的图片在小程序里显示不出来映射路径与绝对地址报修图片上传是个高频难点。后端把图片存到本地 C:/upload/property/返回给前端的是一个相对路径 /upload/xxx.jpg小程序拿这个路径直接渲染时 404。原因是 Spring Boot 默认不对本地磁盘路径做静态资源映射。解决方法是写一个 WebMvcConfigurer 配置类把 /upload/** 映射到本地目录Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String path file:C:/upload/property/; registry.addResourceHandler(/upload/**).addResourceLocations(path); } }这段配置在答辩时是加分项因为它体现了你处理过真实工程问题。需要注意 path 末尾的斜杠不能丢Windows 下需要写成 file 协议加盘符绝对路径Linux 下是 file:/home/xxx/upload/。还有一点很容易踩如果你把图片存到数据库里以 base64 方式存虽然显示没问题但数据库会迅速膨胀论文里不建议这种方案存路径才是标准做法。4.5 Maven 下载依赖卡住或找不到包镜像与版本仲裁第一次执行 mvn spring-boot:run 时依赖下载慢或直接卡住几乎都是因为访问 Maven 中央仓库网络不稳定。解决方式是改仓库为阿里云镜像修改 Maven 安装目录 conf/settings.xml 里的 mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror配置后重新执行 mvn clean install -DskipTests看依赖能不能一次拉全。如果报找不到某个依赖包最常见原因是 Spring Boot 和 MyBatis-Plus 版本不兼容特别是 MyBatis-Plus 3.5.3 之后对 Spring Boot 3 的支持是单独 artifact 的。项目里用什么 Spring Boot 版本就查对应版本号的 MyBatis-Plus 初始化依赖不要混用这是从一堆同学翻车现场总结出来的铁律。检查无效时删除本地仓库里的对应依赖目录 ~/.m2/repository重新下载一次多半是上次下载中断留下的半成品损坏文件。5. 答辩前值得加的两个能力接口鉴权与演示数据设计如果源码本身已经把业务功能都跑通了下一步就是思考“怎么让它看起来更像一个真正的产品”。下面两个增强方案难度都不高但答辩印象分提升非常明显。5.1 用 JWT 给后端接口加一道登录校验前面登录接口里生成的 UUID token 存在哪没存。这意味着任何客户端只要拿着一个合法 UUID就能伪装成任意用户。标准做法是用 JWT把用户 id、房号、过期时间写进 token 本身后端验签就能确认身份不需要服务端保存会话。要加这个能力后端引入 jjwt 依赖dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-impl/artifactId version0.11.5/version /dependency登录成功后生成 tokenString token Jwts.builder() .setSubject(owner.getId().toString()) .claim(phone, owner.getPhone()) .setExpiration(new Date(System.currentTimeMillis() 7 * 24 * 3600 * 1000L)) .signWith(Keys.hmacShaKeyFor(secretKey.getBytes()), SignatureAlgorithm.HS256) .compact();再写一个拦截器拦截 /api/** 下的所有请求排除登录接口和公告查询接口从 header 里取 token 验证。验证失败直接返回 401 JSON 而不是继续调 service。这个改动大约 40 行代码但它回答了一个答辩必问问题“你的系统怎么保证接口安全”。只需要在论文里把这一节写清楚讲的时候把拦截器类打开给老师看这条大加分基本稳定。5.2 演示数据怎么准备答辩现场按什么顺序操作答辩翻车最多的不是代码跑不起来而是演示时数据库是空的页面上一片白老师看着尴尬你再厉害也展示不出来。我的教训是正式答辩前一定要灌一套精心设计的演示数据并且演示顺序按故事线走。数据准备可以按小区实际生活场景来造5 户业主、3 条已发布公告、2 条待处理报修比如 3-1202 漏水、5-801 门禁坏了、1 条已缴费用和 2 条未缴费用。这些数据保证了你打开每个页面都有内容可讲。演示顺序建议是先打开首页展示公告和缴费提醒再切到报修页提交一条新报修然后切到管理后台处理这条报修处理完回小程序列表刷新看到状态变成已完成。这个流程串起来就是一条完整业务闭环比零散点开每个菜单讲一遍有说服力得多。准备一个小本子记下演示账号密码、数据库名和启动顺序答辩现场紧张时照着念就行。最后提醒一句如果你准备在演示时临时删一条数据展示删除功能务必记得提前备份数据库现场把重要数据删错没有后悔药。做这一行永远留着后手数据操作前先备份备份了就永远不慌。希望帮到你。本文还有配套的精品资源点击获取 小区物业管理系统毕设实战：Spring Boot+微信小程序+MySQL前后端源码解析
简介面向小程序毕业设计与课程设计场景这份小区物业管理系统源码包将微信小程序前端与 Java 后端形成完整项目。业主端覆盖报修管理、缴欠费查询、房屋与业主信息查询管理员端覆盖权限、报修、缴欠费、房屋与业主信息管理共九大模块便于直接移植或二次扩展。环境要求 JDK1.8、MySQL5.7 及以上小程序端支持 uniapp 或原生微信小程序配套文档齐全。包体共 405 个文件压缩后约 47.02MB核心类型包括 wxml/wxss 页面与样式、java 业务逻辑、js 逻辑与 json 配置、sql 数据库脚本、doc/docx 设计说明及 avi 操作演示录屏目录清晰便于按模块查找目前已有 58 人学习/下载。读者可获得前后端源码、数据库初始化脚本、说明文档与演示视频既能快速跑通系统流程也可参考模块划分撰写毕业设计论文对需要完成课程设计或毕业设计的计算机专业学生尤为实用。1. 一份小区物业管理系统源码毕业设计为什么绕不开它小程序毕业设计选来选去最后还是落到“小区物业管理系统”上的学生非常多。原因很直接这个业务不需要懂物流、金融、电商那些复杂领域业主端做报修、缴费、公告物业端做工单处理、费用管理、后台统计功能边界清晰前后端和 MySQL 都能覆盖到答辩时也容易讲明白。标题里“完整前后端mysql说明文档LW”这套交付物意味着你拿到的不是一段半成品——小程序端、管理端、数据库脚本、说明文档和论文材料是齐的。适合两类人一类是时间紧、想快速跑通并理解一套可靠全栈模板的毕业生另一类是刚学完 Spring Boot 和微信小程序想找一个完整项目练手、知道每层代码该放哪的初学者。2. 拆系统模块、数据表和选型先把地基打好拿到一份源码先别急着跑第一步是把它的骨架拆明白。很多人在本地起服务时一脸懵就是因为不知道哪个表对应哪个页面、哪个接口叫什么名字。下面按照“页面模块 → 数据库表 → 框架选型”的顺序把系统拆开看。2.1 模块怎么分业主端与物业端各要什么页面常见做法是把系统拆成两个端业主端跑在微信小程序里物业端跑在 Web 管理后台里。双方操作同一个 MySQL 数据库只是入口不同。业主端小程序通常围绕“住”这个场景展开核心页面就四个。首页展示物业公告和缴费提醒报修页面提交家里的漏水、电路、门禁故障上传图片和描述缴费页面查看水电物业费账单并模拟支付我的页面展示住户信息、报修记录和缴费历史。支付环节在毕设里一般不做真实微信支付用一个“模拟已支付”按钮带过这是答辩可以接受的简化要在论文里写清楚。物业端管理后台则走反向流程登录后进入工单列表处理业主报修并回填处理状态发布和下线公告录入每户的月度费用账单查看小区房屋与业主信息。如果选题再扩展一点还可以加车位管理、访客登记但毕设不建议贪多把上面这些跑通已经能支撑一个完整答辩。这两个端的数据流向也很清晰小程序端通过 ajax 请求调用后端 controller 层接口后端 service 层处理业务mapper 层操作 MySQL结果沿原路返回小程序再刷新页面。理解了这条链路后面所有代码都能对号入座。2.2 MySQL 表设计五张核心表与关键字段打开源码里的 sql 目录初始化脚本一般会建 six 到八张表但核心是下面五张管理员表、业主表、报修表、缴费表和公告表。表设计是答辩常被追问的点下面把每张表的关键字段列出来。管理员表 admin_user 存后台登录账号字段包括 id、username、password、real_name、create_time。password 注意看源码里是明文还是 MD5 加密如果论文里写“系统做了安全防护”那这里至少得是 MD5 加盐。业主表 owner_user 对应小程序端用户字段有 id、room_no房号、name、phone、password、create_time。room_no 常被用来做登录账号比如输入 3-1202 加手机号登录这种设计比自增 id 更贴近真实场景。报修表 repair_order 是业务核心字段包括 id、owner_id、type报修类型、description、image_url、status、create_time、handle_time。status 是整个系统的关键一般用整数表示0 待受理、1 处理中、2 已完成、3 已驳回。答辩时老师很喜欢问“状态流转怎么实现的”答案就在这个字段上前端按钮根据 status 不同显示不同操作。缴费表 fee_record 字段有 id、owner_id、fee_type物业费、水费、电费、amount、pay_status、due_time、pay_time。pay_status 用 0 未缴 1 已缴首页的缴费提醒就是查 pay_status 0 的记录。公告表 notice 最简单id、title、content、create_time 四列就够发布公告页面 insert 一条首页查最近五条展示。表之间用外键还是不用的老问题也会被问到。我的建议是逻辑外键代替物理外键。代码里用 owner_id 关联但不在数据库层面建 FOREIGN KEY理由是毕设项目数据量小物理外键不影响性能但会在删除演示数据时带来一堆约束报错演示翻车了反而扣分。这个取舍可以在论文里写一段显得你有工程判断力。2.3 框架选型Spring Boot 原生小程序还是 uni-app 一套多端前端选型是这套毕设里最常见的纠结。标题写的是“小程序”具体是原生微信小程序还是 uni-app源码打开看了就知道。但站在你自己做毕设的角度我建议优先选原生微信小程序加 Spring Boot 的组合。理由有三条。第一原生小程序和微信开发者工具配合没有中间层调试报错信息直接不像 uni-app 在某些版本上编译后的小程序端有不一致表现。第二答辩现场通常要投屏演示原生小程序打开即用不用先跑 HBuilderX 再编译。第三网上“微信小程序毕业设计”的资料密度远高于 uni-app你卡住时搜到答案的概率更大。后端框架同理Spring Boot 是目前绝对主流MyBatis-Plus 比原生 MyBatis 少写大量 XML单表 CRUD 甚至不用写 SQL对赶进度的毕业生很友好。MySQL 用 8.0 就好5.7 的安装和驱动写法略旧新踩的坑反而多。下面是一份典型的后端配置文件先开个眼下一章我们在它基础上跑通最小闭环。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/property_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath:mapper/**/*.xml configuration: map-underscore-to-camel-case: true这里有几个坑提前说。url 里的 characterEncodingutf8 必须加上否则中文公告和报修描述入库变问号serverTimezoneAsia/Shanghai 不配的话MySQL 驱动会按 UTC 读取时间录入的数据在页面上差 8 小时这个下一章第 4 节还会再遇到。map-underscore-to-camel-case 是让数据库的 create_time 自动映射到 Java 的 createTime少写一堆手动物理映射这个开关建议保持开启。3. 本地跑通前后端从环境准备到一次完整报修闭环这一章的目标很明确让你在 30 分钟内看到登录页能进、公告能刷、报修能提交成功。前面无论选什么框架这一步的路径是通用的只是命令和目录名可能有差异按你自己的源码结构对照着改。3.1 环境清单JDK、Maven、MySQL 8、微信开发者工具先列一个环境清单对照你机器上已有的再动手。JDK 建议 1.8 或 11Spring Boot 2.x 系列在这两个版本上都稳定如果你源码用的是 Spring Boot 3那 JDK 得升到 17。版本不对最常见的现象是启动直接抛 UnsupportedClassVersionError看到它先查 JDK 而不是查代码。Maven 用 3.6.3 以上版本即可它负责拉取 Spring Boot、MyBatis-Plus 这些依赖。MySQL 用 8.0安装时要记好 root 密码并在初始化脚本里确认数据库名。微信开发者工具用来跑小程序端安装后需要你注册一个个人小程序账号申请一个 AppID没有 AppID 可以用测试号但测试号不支持部分云能力仅本地调试是够的。数据库初始化这步最容易出错进 Navicat 或命令行执行脚本前先手动建一个空库mysql -uroot -p123456 -e CREATE DATABASE IF NOT EXISTS property_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p123456 --default-character-setutf8mb4 property_db sql/property_db.sql参数说明-u 后跟用户名-p 后跟密码数据库名 property_db 要和后端 application.yml 里的 url 路径一致否则后面启动提示 Unknown database。--default-character-setutf8mb4 是为了让中文表数据在导入时不乱码这是 MySQL 8 命令行导入最容易被忽略的一个参数。导入完成后用 show tables 看到那几张核心表就说明数据层准备好了。3.2 后端工程结构Controller、Service、Mapper 三层的组织方式打开后端源码目录标准 Maven 工程应该是这样的结构如果你手里的组织方式略有不同只要分层思路一致就没问题property-server/ ├── pom.xml ├── src/main/java/com/example/property/ │ ├── PropertyApplication.java │ ├── controller/ │ │ ├── AuthController.java │ │ ├── RepairController.java │ │ └── NoticeController.java │ ├── service/ │ │ ├── OwnerService.java │ │ ├── RepairService.java │ │ └── FeeService.java │ ├── mapper/ │ │ ├── OwnerMapper.java │ │ ├── RepairMapper.java │ │ └── FeeMapper.java │ └── entity/ │ ├── Owner.java │ ├── RepairOrder.java │ └── Notice.java ├── src/main/resources/ │ ├── application.yml │ └── mapper/ └── sql/ └── property_db.sqlController 层只做两件事接收前端请求参数、返回统一结构给前端。业务判断全部下放到 Service。Mapper 层继承 MyBatis-Plus 的 BaseMapper 后insert、selectById、updateById 这些单表操作直接就有不需要自己写 SQL。判断源码靠不靠谱的一个小技巧是看 Service 层有没有厚度如果 Controller 里直接调 mapper查完直接返回说明这套代码只做了增删改查答辩时老师深入问两句就容易露怯。启动后端前先确认 8080 端口没被占用然后在项目根目录执行mvn spring-boot:run看到 “Started PropertyApplication” 日志后浏览器访问 http://localhost:8080/api/notice/list如果返回一串 JSON 公告数据后端就是通的。如果启动报数据库连接失败回头检查 application.yml 里的数据库名、用户名、密码这三项这个排错在第 4 章细说。3.3 登录接口与小程序的 wx.login 对接小程序端登录是前后端联动最典型的场景。常见做法是先调 wx.login 获取一个临时 code再用 code 去后端换取自己系统的业务凭证。但毕设项目里我建议换个更稳的路子直接用账号密码登录用户名存房号或手机号后端校验后返回一个 token 给小程序存起来。原因很现实微信 code2session 需要配置 AppSecret而且 code 换 openid 的接口在开发工具和真机上都有不少玄学问题答辩现场演示失败的概率不低。用账号密码登录只要数据库里有这条业主记录就能进演示掌控度更高。后端的登录接口大致长这样RestController RequestMapping(/api/auth) public class AuthController { private final OwnerService ownerService; public AuthController(OwnerService ownerService) { this.ownerService ownerService; } PostMapping(/login) public Result login(RequestBody LoginRequest req) { Owner owner ownerService.lambdaQuery() .eq(Owner::getPhone, req.getPhone()) .one(); if (owner null || !owner.getPassword().equals(req.getPassword())) { return Result.error(账号或密码错误); } String token UUID.randomUUID().toString().replace(-, ); return Result.success(token); } }login 方法先通过手机号查业主记录再比对密码这里没有做加密是简化演示用的真实项目密码必须走 MD5 加盐或 BCrypt论文里要嘴上承认“生产环境应升级”。token 生成比较粗暴直接 UUID够用但不可扩展第 5 章会给一个 JWT 的更正规做法。小程序端 app.js 里这样对接登录态App({ onLaunch() { const token wx.getStorageSync(token) if (!token) { this.login() } }, login() { wx.request({ url: http://127.0.0.1:8080/api/auth/login, method: POST, data: { phone: 13800000000, password: 123456 }, success: (res) { wx.setStorageSync(token, res.data.data) } }) } })代码里故意写死了演示账号你可以改成从登录页表单里读取。wx.setStorageSync 把 token 存到本地缓存之后每次请求在 header 里带上它后端就能识别当前用户。注意 url 用了 127.0.0.1 而不是 localhost原因是某些 Windows 环境下 localhost 会被解析成 IPv6 ::1后端只监听 IPv4 时请求就失败。3.4 提交一条报修单前端表单到后端落库的完整路径跑通闭台最快的方式是走一遍报修流程小程序填报修单后端落库物业后台看到未处理记录处理后再回到小程序列表。先看后端提交接口PostMapping(/submit) public Result submit(RequestBody RepairOrder order) { order.setStatus(0); // 新提交默认待受理 order.setCreateTime(LocalDateTime.now()); // 补全创建时间 repairService.save(order); return Result.success(order.getId()); }前端小程序的提交代码如下submitRepair() { const that this wx.request({ url: http://127.0.0.1:8080/api/repair/submit, method: POST, header: { token: wx.getStorageSync(token) }, data: { type: this.data.type, description: this.data.description, imageUrl: this.data.imageUrl, ownerId: this.data.ownerId }, success(res) { if (res.data.code 200) { wx.showToast({ title: 提交成功 }) that.loadRepairList() } } }) }这段逻辑里有关键一点值得在答辩时主动提后端没有信任前端传的 ownerId而是应该从 token 去解析当前登录用户这个安全思路会在第 5 章用 JWT 修正。前端只负责采集信息和展示结果业务判断必须留在后端这是我做这类项目反复强调的一道原则。刚提交的报修单在列表页是看不到完成的因为 status 还是 0。你可以直接改数据库把这条记录的 status 改成 2也可以在管理后台点一下“处理完成”按钮后者更符合演示逻辑。完整闭环跑通后你会对“小程序发起请求 → 后端处理 → 数据库落库 → 再查出来展示”这条链路有切身感觉后面答辩被问“前后端怎么交互”时就用这条报修链路讲比背概念清楚得多。4. 小区物业管理系统避坑指南5 个翻车点与排错方法这一章是血泪经验部分。下面 5 个问题是我见过几乎每个跑这套系统的人都会撞上的按出现频率从高到低排每条都按“现象 → 原因 → 解决”写清楚。4.1 MySQL 连不上ERROR 2003 和 Access denied 怎么定位后端启动时最常见的就是两个错误。一个是 Cant connect to MySQL server on localhost (10061) 或 ERROR 2003 (HY000)意思是网络层没连上 MySQL 服务。先检查 MySQL 服务是否启动Windows 在服务管理器里看 MySQL80 是否在运行Linux 执行 systemctl status mysqld没启动就用 systemctl start mysqld。另一个是 Access denied for user rootlocalhost说明账号密码不对。用命令行敲 mysql -uroot -p你的密码 试一下能进数据库就排除 MySQL 本身问题再回来核对 application.yml 里的密码。端口 3306 被占也常发生换机后第一次启动时提示端口占用多半是之前装过别的 MySQL 实例改端口或用 Navicat 连一下看看哪个实例在跑。4.2 小程序 request 一直 fail本地调试时先关掉域名校验小程序发请求给 http://127.0.0.1:8080 大概率会 fail报 url not in domain list。微信小程序对网络请求有域名白名单限制正式发布必须使用备案过的 HTTPS 域名但本地调试不用。解决方法在微信开发者工具右上角“详情 → 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”勾完重新编译立即生效。这个操作在答辩现场也常被问到直接回答“本地开发阶段关闭域名校验线上部署时会配 HTTPS 正式域名”再加一句“内置了域名配置常量切换环境只需要改一个变量”这就叫有工程意识老师不会追问过深。注意如果用了真机预览手机和电脑要连同一个局域网且 url 改成电脑的局域网 IP127.0.0.1 在手机上指向手机自身这个细节能省你半小时。4.3 时间字段差 8 小时JSON 序列化与 JDBC 时区配置列表页显示报修时间总比录入时间早 8 小时最常见的原因是 JDBC 连接没指定时区。MySQL 8 驱动默认用服务器时区如果服务器设成 UTCJava 这边转出来就是 UTC 时间显示成北京就少了 8 小时。解决方法是 application.yml 里 url 加 serverTimezoneAsia/Shanghai同时实体类的 LocalDateTime 字段加一个 Jackson 配置保证 JSON 输出格式统一JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8) private LocalDateTime createTime;这个注解的作用是告诉 Jackson 序列化时用哪个时区和格式不写的话返回给小程序的是数组形式的日期结构前端解析反而更费劲。时间问题排查时先看数据库原始时间对不对库里的值对就是后端转换问题库里都不对就是录入端问题按这个顺序查最省力。4.4 上传的图片在小程序里显示不出来映射路径与绝对地址报修图片上传是个高频难点。后端把图片存到本地 C:/upload/property/返回给前端的是一个相对路径 /upload/xxx.jpg小程序拿这个路径直接渲染时 404。原因是 Spring Boot 默认不对本地磁盘路径做静态资源映射。解决方法是写一个 WebMvcConfigurer 配置类把 /upload/** 映射到本地目录Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String path file:C:/upload/property/; registry.addResourceHandler(/upload/**).addResourceLocations(path); } }这段配置在答辩时是加分项因为它体现了你处理过真实工程问题。需要注意 path 末尾的斜杠不能丢Windows 下需要写成 file 协议加盘符绝对路径Linux 下是 file:/home/xxx/upload/。还有一点很容易踩如果你把图片存到数据库里以 base64 方式存虽然显示没问题但数据库会迅速膨胀论文里不建议这种方案存路径才是标准做法。4.5 Maven 下载依赖卡住或找不到包镜像与版本仲裁第一次执行 mvn spring-boot:run 时依赖下载慢或直接卡住几乎都是因为访问 Maven 中央仓库网络不稳定。解决方式是改仓库为阿里云镜像修改 Maven 安装目录 conf/settings.xml 里的 mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror配置后重新执行 mvn clean install -DskipTests看依赖能不能一次拉全。如果报找不到某个依赖包最常见原因是 Spring Boot 和 MyBatis-Plus 版本不兼容特别是 MyBatis-Plus 3.5.3 之后对 Spring Boot 3 的支持是单独 artifact 的。项目里用什么 Spring Boot 版本就查对应版本号的 MyBatis-Plus 初始化依赖不要混用这是从一堆同学翻车现场总结出来的铁律。检查无效时删除本地仓库里的对应依赖目录 ~/.m2/repository重新下载一次多半是上次下载中断留下的半成品损坏文件。5. 答辩前值得加的两个能力接口鉴权与演示数据设计如果源码本身已经把业务功能都跑通了下一步就是思考“怎么让它看起来更像一个真正的产品”。下面两个增强方案难度都不高但答辩印象分提升非常明显。5.1 用 JWT 给后端接口加一道登录校验前面登录接口里生成的 UUID token 存在哪没存。这意味着任何客户端只要拿着一个合法 UUID就能伪装成任意用户。标准做法是用 JWT把用户 id、房号、过期时间写进 token 本身后端验签就能确认身份不需要服务端保存会话。要加这个能力后端引入 jjwt 依赖dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-impl/artifactId version0.11.5/version /dependency登录成功后生成 tokenString token Jwts.builder() .setSubject(owner.getId().toString()) .claim(phone, owner.getPhone()) .setExpiration(new Date(System.currentTimeMillis() 7 * 24 * 3600 * 1000L)) .signWith(Keys.hmacShaKeyFor(secretKey.getBytes()), SignatureAlgorithm.HS256) .compact();再写一个拦截器拦截 /api/** 下的所有请求排除登录接口和公告查询接口从 header 里取 token 验证。验证失败直接返回 401 JSON 而不是继续调 service。这个改动大约 40 行代码但它回答了一个答辩必问问题“你的系统怎么保证接口安全”。只需要在论文里把这一节写清楚讲的时候把拦截器类打开给老师看这条大加分基本稳定。5.2 演示数据怎么准备答辩现场按什么顺序操作答辩翻车最多的不是代码跑不起来而是演示时数据库是空的页面上一片白老师看着尴尬你再厉害也展示不出来。我的教训是正式答辩前一定要灌一套精心设计的演示数据并且演示顺序按故事线走。数据准备可以按小区实际生活场景来造5 户业主、3 条已发布公告、2 条待处理报修比如 3-1202 漏水、5-801 门禁坏了、1 条已缴费用和 2 条未缴费用。这些数据保证了你打开每个页面都有内容可讲。演示顺序建议是先打开首页展示公告和缴费提醒再切到报修页提交一条新报修然后切到管理后台处理这条报修处理完回小程序列表刷新看到状态变成已完成。这个流程串起来就是一条完整业务闭环比零散点开每个菜单讲一遍有说服力得多。准备一个小本子记下演示账号密码、数据库名和启动顺序答辩现场紧张时照着念就行。最后提醒一句如果你准备在演示时临时删一条数据展示删除功能务必记得提前备份数据库现场把重要数据删错没有后悔药。做这一行永远留着后手数据操作前先备份备份了就永远不慌。希望帮到你。本文还有配套的精品资源点击获取