简介基于SSM框架与微信小程序的物业管理系统是一套可运行的开源项目源码主要面向Java学习者、小程序开发者和寻求信息化升级的物业公司。系统覆盖住户信息、费用管理、报修服务、通知公告、停车场管理等核心业务并包含基础配置、权限控制和数据维护等后台能力后端采用SSM框架整合搭建前端通过微信小程序提供交互界面整体前后端分离、目录结构清晰便于理解架构和二次开发。资源包共560个文件压缩包大小约11.06MB主要涉及XML配置文件、Java后端源码、JS脚本、JSP页面以及微信小程序页面模板与样式表同时还包括图片、字体图标和JSON数据等静态资源能够完整支撑代码阅读、环境部署和功能调试。项目附带详细部署教程可引导用户完成环境准备、源码导入、数据库配置与服务器上线省去四处查找文档的麻烦。目前已有517人学习下载对希望借助SSM和小程序实战项目巩固开发技能、积累企业级系统经验的读者而言是一份实用且可直接上手的参考资料。1. 为什么SSM加小程序恰好卡在物业管理的痛点上物业管理系统的难点不在并发量而在业务数据散、变更频繁、用户角色多。住户要交费、报修、查公告物业要维护房屋、车位、账单、工单如果后端每个模块各写一套逻辑后期维护成本会非常高。SSM框架的价值在于把数据访问、业务逻辑和接口暴露拆成三层配合MyBatis的SQL可控性适合这种表单密集型业务微信小程序的价值则是把物业服务的入口放到微信里住户不需要下载App。我拆这套源码时最明显的感受是项目把前后端分离做得比较务实小程序端直接调SpringMVC的JSON接口后台管理页面则用JSP加layui渲染两者共用一套Service和Mapper。下面从架构设计、部署步骤、核心模块实现、二次开发四个方向展开如果你想用它做毕业设计、课程设计或者公司内部系统都能直接参考。2. SSM框架与微信小程序物业系统的整体架构与关键设计2.1 后端分层Controller、Service、Mapper 的分工与接口约定这套系统后端是典型的SSM三层架构。Controller层只负责接收请求参数、调用Service并包装返回结果不直接写SQLService层处理业务规则比如生成费用流水、校验报修单状态Mapper层通过MyBatis的XML文件把Java方法映射到SQL语句。从源码文件看有96个XML配置文件其中相当一部分是Mapper XML每个模块对应一个。Spring容器里三个层级的装配关系一般通过包扫描和依赖注入完成比如在spring-context.xml里配置context:component-scan base-packagecom.property/ bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.property.dao/ /beanMapperScannerConfigurer负责扫描com.property.dao包下的Mapper接口并把代理对象注入Service。很多新手部署后启动报找不到Mapper多半是basePackage写错了或者Mapper接口没有加Mapper注解。这里给出一个登录接口的完整写法RestController RequestMapping(/api/user) public class UserController { Resource private UserService userService; PostMapping(/login) public ResultMapString, Object login(RequestBody LoginDTO dto) { return userService.login(dto.getUsername(), dto.getPassword()); } }这里用RestController表示所有方法返回值都会被序列化成JSON小程序端直接拿到code、msg、data三字段。注意LoginDTO接收JSON参数而不是传统的RequestParam这样小程序端可以wx.request里设置content-type: application/json来提交。2.2 小程序端页面组成wxml、wxss、js、json 的关系项目里有49个wxss样式文件、19个wxml模板、22个json数据文件说明每个页面都由四个文件组成。wxml定义页面骨架wxss控制样式js写业务逻辑和请求json做页面配置。四个文件的分工如下文件后缀作用对应Web能力.wxml页面结构类似HTML标签.wxss页面样式类似CSS.js页面逻辑数据、事件、请求.json页面配置标题栏、下拉刷新等典型页面请求写法// pages/bill/list.js Page({ data: { billList: [], loading: false }, onLoad() { this.loadBills(); }, loadBills() { this.setData({ loading: true }); wx.request({ url: getApp().globalData.baseUrl /api/bill/list, data: { userId: wx.getStorageSync(userId) }, success: (res) { if (res.data.code 0) { this.setData({ billList: res.data.data }); } }, complete: () this.setData({ loading: false }) }); } });注意getApp().globalData.baseUrl是全局配置通常写在小程序根目录的app.js里。wx.getStorageSync(userId)从本地缓存取登录用户ID这样做的好处是接口无状态后端不需要关心小程序端的会话坏处是用户ID可以被伪造所以真实项目中更要考虑token鉴权后面会讲。列表页的下拉刷新通常用enablePullDownRefresh配置在页面json文件里加上enablePullDownRefresh: true然后在Page的onPullDownRefresh里重新拉取数据并调用wx.stopPullDownRefresh()。这个小功能涉及三个文件的改动也最容易被人漏掉。2.3 数据库设计从物业业务反推核心表结构从功能模块拆最少需要这五张表房屋表house、住户表user、账单表bill、报修表repair、车位表parking_space。其中账单表要冗余房屋ID和住户ID避免每次都关联三张表查费用明细。建表SQL示例CREATE TABLE bill ( id INT PRIMARY KEY AUTO_INCREMENT, house_id INT NOT NULL COMMENT 房屋ID, owner_id INT NOT NULL COMMENT 住户ID, bill_type TINYINT NOT NULL COMMENT 1物业费 2水费 3电费, amount DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0 COMMENT 0未缴 1已缴, due_time DATETIME NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_owner_status (owner_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;bill_type用TINYINT而不是VARCHAR是为了方便统计报表时对账单类型分组求和。amount用DECIMAL(10,2)避免浮点精度问题。实际源码里可能还加了month字段用于按月生成账单二次开发时可以在due_time上加索引因为缴费提醒的后台任务会频繁按到期时间筛选。后续要接微信支付可以在表里加order_no和pay_time字段把支付单号和业务账单绑定。房屋表与住户表之间是1对多关系一个家庭可以有多位住户所以在house表里不需要存owner_id反而应该在user表上加house_id外键。建表时加上idx_owner_status这样的联合索引能明显加快某个住户的未缴账单这类查询。3. 从源码结构到本机部署完整的部署步骤与参数说明3.1 导入项目前的环境准备JDK、Maven、Tomcat、MySQL 版本怎么选源码里有.classpath和org.eclipse.wst.common.component文件这是Eclipse的工程描述文件说明原项目是在Eclipse中用Maven构建的。为了少踩坑建议用JDK 1.8、Maven 3.6、Tomcat 8.5、MySQL 5.7。JDK 11以上可能会遇到Tomcat版本不匹配MySQL 8.0需要改驱动类名和URL时区参数。环境版本对应关系组件推荐版本注意事项JDK1.8不要用17避免编译选项不兼容Maven3.6.x用阿里云镜像加速依赖下载Tomcat8.5支持Servlet 3.1和Spring 5匹配MySQL5.7兼容性最好连接串不用加时区参数打开pom.xml确认Spring版本。如果是Spring 4.x需要配spring-webmvc、mybatis-spring等依赖Spring 5.x则要注意javax包名还是jakarta包名。项目自带96个XML文件其实很多是MyBatis的Mapper文件不要误删。Maven下载依赖慢的解决办法是在settings.xml的mirrors节点加阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror3.2 后端启动数据库初始化与参数修改先创建数据库并导入项目中的sql目录脚本mysql -uroot -p -e CREATE DATABASE property DEFAULT CHARSET utf8mb4; mysql -uroot -p property sql/property.sql没有脚本的话用逆向工程从Mapper XML里的表名、字段名反推建表语句。然后修改jdbc.properties常见文件名源码里可能是db.propertiesjdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/property?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456这里最关键的是characterEncodingutf8否则控制台输出中文会变成问号。MySQL 5.7驱动类是com.mysql.jdbc.Driver如果切换到5.7的高版本驱动比如5.1.49也可用。改完后在项目根目录执行mvn clean package -DskipTests构建成功后把target目录下的war包放到Tomcat的webapps下启动Tomcat。或者直接在Eclipse里配置Tomcat Server右键运行。启动后访问http://localhost:8080/property-api/能看到管理后台或接口文档页面说明后端已经起来了。如果碰到404先看Tomcat的logs/catalina.out里的报错多半是Spring容器没加载完。3.3 小程序端运行微信开发者工具与baseUrl配置打开微信开发者工具导入项目根目录下的小程序文件夹可能是miniprogram或者根目录的pages。关键步骤在app.js里把baseUrl改成后端的局域网地址比如http://192.168.31.10:8080/property-api点击详情勾选不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书如果小程序端是使用wx.request手机预览时必须在同一WiFi下且后端Tomcat关闭了防火墙。// app.js App({ globalData: { baseUrl: http://192.168.31.10:8080/property-api } })这里不校验域名只适用于本地开发。真正发布时所有接口域名必须换成HTTPS地址并且在微信公众平台后台配置request合法域名。3.4 验证部署用curl测试接口能否走通后端启动后先用命令行验证一下接口不要急着点小程序页面curl -X POST http://localhost:8080/property-api/api/user/login \ -H Content-Type: application/json \ -d {username:admin,password:123456}返回{code:0,msg:success,data:{token:...}说明接口正常。如果返回404检查Controller的RequestMapping路径和小程序端请求路径是否完全一致如果返回500看Tomcat日志SQL问题居多。然后用同样的方式拉取账单列表确认数据库连接没问题。这一步能避免前端界面和后端问题混杂在一起时无处下手。4. 核心业务模块的实现解析费用管理、报修流程与权限控制4.1 费用管理账单生成与分页查询的SQL与Java配合费用管理是物业系统的核心源码里JSP页面用layui渲染后台账单表格小程序端展示未缴账单。后端查询方法通常是public PageResultBillVO queryBillPage(Query query) { PageHelper.startPage(query.getPageNum(), query.getPageSize()); ListBillVO list billMapper.selectBillList(query); return new PageResult((Page) list); }使用PageHelper做分页时必须确保它生效。常见问题是依赖冲突导致分页失效排查方式是在Mapper XML里打印SQL或者看控制台有没有PageHelper is not compatible警告。对应的Mapper XML片段select idselectBillList resultTypecom.xxx.vo.BillVO SELECT b.id, h.room_no, u.real_name, b.amount, b.status FROM bill b LEFT JOIN house h ON b.house_id h.id LEFT JOIN user u ON b.owner_id u.id where if testroomNo ! null and roomNo ! AND h.room_no LIKE CONCAT(%, #{roomNo}, %) /if if teststatus ! null AND b.status #{status} /if /where ORDER BY b.created_at DESC /selectwhere标签和if标签是MyBatis动态SQL的基础用法好处是根据传入条件自动拼接WHERE子句并去掉多余的AND。这里LIKE CONCAT(%, #{roomNo}, %)是推荐的模糊查询写法避免直接把%拼在参数里造成SQL注入。ORDER BY一定要加否则数据量多了会出现不同页重复记录。物业费账单还要按月生成的场景建议写一个定时任务Scheduled(cron 0 0 0 1 * ?)每月1日凌晨为所有房屋生成当月账单。在Task类里直接调用billService.generateMonthlyBill()循环插入数据时尽量用批量插入避免逐条执行SQL导致接口超时。批量插入时注意MyBatis的foreach和MySQL的allowMultiQueries配置这里不展开但这类问题在源码二次开发中很容易遇到。4.2 报修工单状态流转小程序端如何驱动后端状态机报修流程通常涉及四个状态待处理0、处理中1、待确认2、已完成3。后端Service里通过状态流转校验防止用户跳过步骤。当前状态可跳转状态触发方0 待处理1 处理中物业管理员1 处理中2 待确认维修人员2 待确认3 已完成住户状态流转代码private static final MapInteger, ListInteger REPAIR_TRANSITIONS new HashMap(); static { REPAIR_TRANSITIONS.put(0, Arrays.asList(1)); // 待处理 - 处理中 REPAIR_TRANSITIONS.put(1, Arrays.asList(2)); // 处理中 - 待确认 REPAIR_TRANSITIONS.put(2, Arrays.asList(3)); // 待确认 - 已完成 } public void updateStatus(Integer repairId, Integer fromStatus, Integer toStatus) { if (!REPAIR_TRANSITIONS.getOrDefault(fromStatus, Collections.emptyList()).contains(toStatus)) { throw new BizException(非法的状态变更); } repairMapper.updateStatus(repairId, toStatus); }这里用Map定义状态转移表代码注释标出每次允许的跳转。为什么不直接在SQL里UPDATE repair SET status #{toStatus} WHERE id #{id} AND status #{fromStatus}因为业务校验放在Java层能给出更明确的错误信息SQL的乐观更新适合并发场景。两者结合是更稳的做法Java层校验SQL里再带上AND status #{fromStatus}影响行数为0说明状态已经被别人改了。小程序端报修页面提交后通常用wx.showToast提示提交成功然后wx.navigateBack返回到列表页。列表页在onShow里重新加载数据这样能保证看到最新状态。对于待确认这个状态可以给住户显示确认完成按钮给物业显示派工按钮使用wx:if根据status字段渲染不同操作按钮。block wx:if{{item.status 2}} button sizemini bindtapconfirmFinish>public class AuthInterceptor implements HandlerInterceptor { private MapString, Integer tokenStore new ConcurrentHashMap(); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token null || !tokenStore.containsKey(token)) { response.setStatus(401); return false; } request.setAttribute(userId, tokenStore.get(token)); return true; } }在SpringMVC配置文件中注册拦截器mvc:interceptors mvc:interceptor mvc:mapping path/api/**/ mvc:exclude-mapping path/api/user/login/ mvc:exclude-mapping path/api/user/register/ bean classcom.xxx.interceptor.AuthInterceptor/ /mvc:interceptor /mvc:interceptorstokenStore用ConcurrentHashMap只是为了演示实际项目应该存到Redis并设置过期时间不然重启服务所有token就失效了。注意拦截器的exclude-mapping要配置登录和注册接口否则小程序第一次登录都进不来。调用wx.request时需要在header里携带tokenwx.request({ url: getApp().globalData.baseUrl /api/repair/list, header: { token: wx.getStorageSync(token) }, success(res) { } });这里把token放在header而不是URL参数能避免日志里打出完整token。Session方案和token方案的核心区别在于Session把状态保存在服务端需要处理跨域Cookie携带token把状态绑定在客户端服务端只需验签或查表。对于小程序端token方案明显更方便尤其在同一个后端要同时服务小程序和后台管理系统时管理端可以继续用Session小程序端用token互不干扰。5. 二次开发与联调排错从改页面到接口验证的一整套思路5.1 从新增模块到联调一次完整的改动路径如果想加一个访客登记功能可以按这个顺序改动先在数据库建visitor表再写VisitorMapper.java和VisitorMapper.xml然后VisitorService、VisitorController最后在小程序端加新建页面在app.json里注册路由。其中最容易漏的是app.json的pages数组不注册页面会导致page not found。我把常见报错按现象做了分类报错现象排查位置典型原因404 Not FoundController路径、Tomcat上下文请求URL与RequestMapping不一致405 Method Not Allowed请求方法用POST请求但接口是GetMapping500 空指针Service/DAOResource注入失败Mapper未扫描中文乱码JSP或数据库配置未统一UTF-8或JDBC URL漏掉编码参数连接拒绝baseUrl、Tomcat端口小程序真机访问了localhost5.2 联调高频坑从开发者工具到真机预览当出现request:fail时先打开微信开发者工具右上角的Network面板确认请求有没有发出。如果请求是红色且状态码为0多半是域名没有勾选不校验或者手机和电脑不在同一局域网。桌面端可以先用浏览器直接访问后端接口排除后端问题再用抓包工具看小程序实际发送的请求体这样能快速定位是前端参数问题还是后端逻辑问题。小程序端的wx.request在正式环境要求请求地址必须备案且是HTTPS所以在开发阶段只能用不校验域名这个开关。5.3 用日志和慢查询定位性能瓶颈调试阶段可以在Service方法里用log4j打点long start System.currentTimeMillis(); ListBillVO list billMapper.selectBillList(query); log.info(query bill cost {} ms, System.currentTimeMillis() - start);如果某些接口耗时超过1秒优先看Mapper SQL的EXPLAIN执行计划检查有没有全表扫描。物业系统的数据量远没到需要分库分表的地步把慢查询加上索引性能问题基本就解决了。我把这套源码里最容易拖慢查询的字段都检查过一遍repair表的status、bill表的owner_id、notice表的publish_time都值得建索引。另外数据库连接池参数里maxActive不要设得太大Tomcat默认线程池也就200连接池设50就够了配多了反而会因为空闲连接过多拖慢响应。本文还有配套的精品资源点击获取 SSM框架与微信小程序物业管理系统源码解析与部署实践
简介基于SSM框架与微信小程序的物业管理系统是一套可运行的开源项目源码主要面向Java学习者、小程序开发者和寻求信息化升级的物业公司。系统覆盖住户信息、费用管理、报修服务、通知公告、停车场管理等核心业务并包含基础配置、权限控制和数据维护等后台能力后端采用SSM框架整合搭建前端通过微信小程序提供交互界面整体前后端分离、目录结构清晰便于理解架构和二次开发。资源包共560个文件压缩包大小约11.06MB主要涉及XML配置文件、Java后端源码、JS脚本、JSP页面以及微信小程序页面模板与样式表同时还包括图片、字体图标和JSON数据等静态资源能够完整支撑代码阅读、环境部署和功能调试。项目附带详细部署教程可引导用户完成环境准备、源码导入、数据库配置与服务器上线省去四处查找文档的麻烦。目前已有517人学习下载对希望借助SSM和小程序实战项目巩固开发技能、积累企业级系统经验的读者而言是一份实用且可直接上手的参考资料。1. 为什么SSM加小程序恰好卡在物业管理的痛点上物业管理系统的难点不在并发量而在业务数据散、变更频繁、用户角色多。住户要交费、报修、查公告物业要维护房屋、车位、账单、工单如果后端每个模块各写一套逻辑后期维护成本会非常高。SSM框架的价值在于把数据访问、业务逻辑和接口暴露拆成三层配合MyBatis的SQL可控性适合这种表单密集型业务微信小程序的价值则是把物业服务的入口放到微信里住户不需要下载App。我拆这套源码时最明显的感受是项目把前后端分离做得比较务实小程序端直接调SpringMVC的JSON接口后台管理页面则用JSP加layui渲染两者共用一套Service和Mapper。下面从架构设计、部署步骤、核心模块实现、二次开发四个方向展开如果你想用它做毕业设计、课程设计或者公司内部系统都能直接参考。2. SSM框架与微信小程序物业系统的整体架构与关键设计2.1 后端分层Controller、Service、Mapper 的分工与接口约定这套系统后端是典型的SSM三层架构。Controller层只负责接收请求参数、调用Service并包装返回结果不直接写SQLService层处理业务规则比如生成费用流水、校验报修单状态Mapper层通过MyBatis的XML文件把Java方法映射到SQL语句。从源码文件看有96个XML配置文件其中相当一部分是Mapper XML每个模块对应一个。Spring容器里三个层级的装配关系一般通过包扫描和依赖注入完成比如在spring-context.xml里配置context:component-scan base-packagecom.property/ bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.property.dao/ /beanMapperScannerConfigurer负责扫描com.property.dao包下的Mapper接口并把代理对象注入Service。很多新手部署后启动报找不到Mapper多半是basePackage写错了或者Mapper接口没有加Mapper注解。这里给出一个登录接口的完整写法RestController RequestMapping(/api/user) public class UserController { Resource private UserService userService; PostMapping(/login) public ResultMapString, Object login(RequestBody LoginDTO dto) { return userService.login(dto.getUsername(), dto.getPassword()); } }这里用RestController表示所有方法返回值都会被序列化成JSON小程序端直接拿到code、msg、data三字段。注意LoginDTO接收JSON参数而不是传统的RequestParam这样小程序端可以wx.request里设置content-type: application/json来提交。2.2 小程序端页面组成wxml、wxss、js、json 的关系项目里有49个wxss样式文件、19个wxml模板、22个json数据文件说明每个页面都由四个文件组成。wxml定义页面骨架wxss控制样式js写业务逻辑和请求json做页面配置。四个文件的分工如下文件后缀作用对应Web能力.wxml页面结构类似HTML标签.wxss页面样式类似CSS.js页面逻辑数据、事件、请求.json页面配置标题栏、下拉刷新等典型页面请求写法// pages/bill/list.js Page({ data: { billList: [], loading: false }, onLoad() { this.loadBills(); }, loadBills() { this.setData({ loading: true }); wx.request({ url: getApp().globalData.baseUrl /api/bill/list, data: { userId: wx.getStorageSync(userId) }, success: (res) { if (res.data.code 0) { this.setData({ billList: res.data.data }); } }, complete: () this.setData({ loading: false }) }); } });注意getApp().globalData.baseUrl是全局配置通常写在小程序根目录的app.js里。wx.getStorageSync(userId)从本地缓存取登录用户ID这样做的好处是接口无状态后端不需要关心小程序端的会话坏处是用户ID可以被伪造所以真实项目中更要考虑token鉴权后面会讲。列表页的下拉刷新通常用enablePullDownRefresh配置在页面json文件里加上enablePullDownRefresh: true然后在Page的onPullDownRefresh里重新拉取数据并调用wx.stopPullDownRefresh()。这个小功能涉及三个文件的改动也最容易被人漏掉。2.3 数据库设计从物业业务反推核心表结构从功能模块拆最少需要这五张表房屋表house、住户表user、账单表bill、报修表repair、车位表parking_space。其中账单表要冗余房屋ID和住户ID避免每次都关联三张表查费用明细。建表SQL示例CREATE TABLE bill ( id INT PRIMARY KEY AUTO_INCREMENT, house_id INT NOT NULL COMMENT 房屋ID, owner_id INT NOT NULL COMMENT 住户ID, bill_type TINYINT NOT NULL COMMENT 1物业费 2水费 3电费, amount DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0 COMMENT 0未缴 1已缴, due_time DATETIME NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_owner_status (owner_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;bill_type用TINYINT而不是VARCHAR是为了方便统计报表时对账单类型分组求和。amount用DECIMAL(10,2)避免浮点精度问题。实际源码里可能还加了month字段用于按月生成账单二次开发时可以在due_time上加索引因为缴费提醒的后台任务会频繁按到期时间筛选。后续要接微信支付可以在表里加order_no和pay_time字段把支付单号和业务账单绑定。房屋表与住户表之间是1对多关系一个家庭可以有多位住户所以在house表里不需要存owner_id反而应该在user表上加house_id外键。建表时加上idx_owner_status这样的联合索引能明显加快某个住户的未缴账单这类查询。3. 从源码结构到本机部署完整的部署步骤与参数说明3.1 导入项目前的环境准备JDK、Maven、Tomcat、MySQL 版本怎么选源码里有.classpath和org.eclipse.wst.common.component文件这是Eclipse的工程描述文件说明原项目是在Eclipse中用Maven构建的。为了少踩坑建议用JDK 1.8、Maven 3.6、Tomcat 8.5、MySQL 5.7。JDK 11以上可能会遇到Tomcat版本不匹配MySQL 8.0需要改驱动类名和URL时区参数。环境版本对应关系组件推荐版本注意事项JDK1.8不要用17避免编译选项不兼容Maven3.6.x用阿里云镜像加速依赖下载Tomcat8.5支持Servlet 3.1和Spring 5匹配MySQL5.7兼容性最好连接串不用加时区参数打开pom.xml确认Spring版本。如果是Spring 4.x需要配spring-webmvc、mybatis-spring等依赖Spring 5.x则要注意javax包名还是jakarta包名。项目自带96个XML文件其实很多是MyBatis的Mapper文件不要误删。Maven下载依赖慢的解决办法是在settings.xml的mirrors节点加阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror3.2 后端启动数据库初始化与参数修改先创建数据库并导入项目中的sql目录脚本mysql -uroot -p -e CREATE DATABASE property DEFAULT CHARSET utf8mb4; mysql -uroot -p property sql/property.sql没有脚本的话用逆向工程从Mapper XML里的表名、字段名反推建表语句。然后修改jdbc.properties常见文件名源码里可能是db.propertiesjdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/property?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456这里最关键的是characterEncodingutf8否则控制台输出中文会变成问号。MySQL 5.7驱动类是com.mysql.jdbc.Driver如果切换到5.7的高版本驱动比如5.1.49也可用。改完后在项目根目录执行mvn clean package -DskipTests构建成功后把target目录下的war包放到Tomcat的webapps下启动Tomcat。或者直接在Eclipse里配置Tomcat Server右键运行。启动后访问http://localhost:8080/property-api/能看到管理后台或接口文档页面说明后端已经起来了。如果碰到404先看Tomcat的logs/catalina.out里的报错多半是Spring容器没加载完。3.3 小程序端运行微信开发者工具与baseUrl配置打开微信开发者工具导入项目根目录下的小程序文件夹可能是miniprogram或者根目录的pages。关键步骤在app.js里把baseUrl改成后端的局域网地址比如http://192.168.31.10:8080/property-api点击详情勾选不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书如果小程序端是使用wx.request手机预览时必须在同一WiFi下且后端Tomcat关闭了防火墙。// app.js App({ globalData: { baseUrl: http://192.168.31.10:8080/property-api } })这里不校验域名只适用于本地开发。真正发布时所有接口域名必须换成HTTPS地址并且在微信公众平台后台配置request合法域名。3.4 验证部署用curl测试接口能否走通后端启动后先用命令行验证一下接口不要急着点小程序页面curl -X POST http://localhost:8080/property-api/api/user/login \ -H Content-Type: application/json \ -d {username:admin,password:123456}返回{code:0,msg:success,data:{token:...}说明接口正常。如果返回404检查Controller的RequestMapping路径和小程序端请求路径是否完全一致如果返回500看Tomcat日志SQL问题居多。然后用同样的方式拉取账单列表确认数据库连接没问题。这一步能避免前端界面和后端问题混杂在一起时无处下手。4. 核心业务模块的实现解析费用管理、报修流程与权限控制4.1 费用管理账单生成与分页查询的SQL与Java配合费用管理是物业系统的核心源码里JSP页面用layui渲染后台账单表格小程序端展示未缴账单。后端查询方法通常是public PageResultBillVO queryBillPage(Query query) { PageHelper.startPage(query.getPageNum(), query.getPageSize()); ListBillVO list billMapper.selectBillList(query); return new PageResult((Page) list); }使用PageHelper做分页时必须确保它生效。常见问题是依赖冲突导致分页失效排查方式是在Mapper XML里打印SQL或者看控制台有没有PageHelper is not compatible警告。对应的Mapper XML片段select idselectBillList resultTypecom.xxx.vo.BillVO SELECT b.id, h.room_no, u.real_name, b.amount, b.status FROM bill b LEFT JOIN house h ON b.house_id h.id LEFT JOIN user u ON b.owner_id u.id where if testroomNo ! null and roomNo ! AND h.room_no LIKE CONCAT(%, #{roomNo}, %) /if if teststatus ! null AND b.status #{status} /if /where ORDER BY b.created_at DESC /selectwhere标签和if标签是MyBatis动态SQL的基础用法好处是根据传入条件自动拼接WHERE子句并去掉多余的AND。这里LIKE CONCAT(%, #{roomNo}, %)是推荐的模糊查询写法避免直接把%拼在参数里造成SQL注入。ORDER BY一定要加否则数据量多了会出现不同页重复记录。物业费账单还要按月生成的场景建议写一个定时任务Scheduled(cron 0 0 0 1 * ?)每月1日凌晨为所有房屋生成当月账单。在Task类里直接调用billService.generateMonthlyBill()循环插入数据时尽量用批量插入避免逐条执行SQL导致接口超时。批量插入时注意MyBatis的foreach和MySQL的allowMultiQueries配置这里不展开但这类问题在源码二次开发中很容易遇到。4.2 报修工单状态流转小程序端如何驱动后端状态机报修流程通常涉及四个状态待处理0、处理中1、待确认2、已完成3。后端Service里通过状态流转校验防止用户跳过步骤。当前状态可跳转状态触发方0 待处理1 处理中物业管理员1 处理中2 待确认维修人员2 待确认3 已完成住户状态流转代码private static final MapInteger, ListInteger REPAIR_TRANSITIONS new HashMap(); static { REPAIR_TRANSITIONS.put(0, Arrays.asList(1)); // 待处理 - 处理中 REPAIR_TRANSITIONS.put(1, Arrays.asList(2)); // 处理中 - 待确认 REPAIR_TRANSITIONS.put(2, Arrays.asList(3)); // 待确认 - 已完成 } public void updateStatus(Integer repairId, Integer fromStatus, Integer toStatus) { if (!REPAIR_TRANSITIONS.getOrDefault(fromStatus, Collections.emptyList()).contains(toStatus)) { throw new BizException(非法的状态变更); } repairMapper.updateStatus(repairId, toStatus); }这里用Map定义状态转移表代码注释标出每次允许的跳转。为什么不直接在SQL里UPDATE repair SET status #{toStatus} WHERE id #{id} AND status #{fromStatus}因为业务校验放在Java层能给出更明确的错误信息SQL的乐观更新适合并发场景。两者结合是更稳的做法Java层校验SQL里再带上AND status #{fromStatus}影响行数为0说明状态已经被别人改了。小程序端报修页面提交后通常用wx.showToast提示提交成功然后wx.navigateBack返回到列表页。列表页在onShow里重新加载数据这样能保证看到最新状态。对于待确认这个状态可以给住户显示确认完成按钮给物业显示派工按钮使用wx:if根据status字段渲染不同操作按钮。block wx:if{{item.status 2}} button sizemini bindtapconfirmFinish>public class AuthInterceptor implements HandlerInterceptor { private MapString, Integer tokenStore new ConcurrentHashMap(); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token null || !tokenStore.containsKey(token)) { response.setStatus(401); return false; } request.setAttribute(userId, tokenStore.get(token)); return true; } }在SpringMVC配置文件中注册拦截器mvc:interceptors mvc:interceptor mvc:mapping path/api/**/ mvc:exclude-mapping path/api/user/login/ mvc:exclude-mapping path/api/user/register/ bean classcom.xxx.interceptor.AuthInterceptor/ /mvc:interceptor /mvc:interceptorstokenStore用ConcurrentHashMap只是为了演示实际项目应该存到Redis并设置过期时间不然重启服务所有token就失效了。注意拦截器的exclude-mapping要配置登录和注册接口否则小程序第一次登录都进不来。调用wx.request时需要在header里携带tokenwx.request({ url: getApp().globalData.baseUrl /api/repair/list, header: { token: wx.getStorageSync(token) }, success(res) { } });这里把token放在header而不是URL参数能避免日志里打出完整token。Session方案和token方案的核心区别在于Session把状态保存在服务端需要处理跨域Cookie携带token把状态绑定在客户端服务端只需验签或查表。对于小程序端token方案明显更方便尤其在同一个后端要同时服务小程序和后台管理系统时管理端可以继续用Session小程序端用token互不干扰。5. 二次开发与联调排错从改页面到接口验证的一整套思路5.1 从新增模块到联调一次完整的改动路径如果想加一个访客登记功能可以按这个顺序改动先在数据库建visitor表再写VisitorMapper.java和VisitorMapper.xml然后VisitorService、VisitorController最后在小程序端加新建页面在app.json里注册路由。其中最容易漏的是app.json的pages数组不注册页面会导致page not found。我把常见报错按现象做了分类报错现象排查位置典型原因404 Not FoundController路径、Tomcat上下文请求URL与RequestMapping不一致405 Method Not Allowed请求方法用POST请求但接口是GetMapping500 空指针Service/DAOResource注入失败Mapper未扫描中文乱码JSP或数据库配置未统一UTF-8或JDBC URL漏掉编码参数连接拒绝baseUrl、Tomcat端口小程序真机访问了localhost5.2 联调高频坑从开发者工具到真机预览当出现request:fail时先打开微信开发者工具右上角的Network面板确认请求有没有发出。如果请求是红色且状态码为0多半是域名没有勾选不校验或者手机和电脑不在同一局域网。桌面端可以先用浏览器直接访问后端接口排除后端问题再用抓包工具看小程序实际发送的请求体这样能快速定位是前端参数问题还是后端逻辑问题。小程序端的wx.request在正式环境要求请求地址必须备案且是HTTPS所以在开发阶段只能用不校验域名这个开关。5.3 用日志和慢查询定位性能瓶颈调试阶段可以在Service方法里用log4j打点long start System.currentTimeMillis(); ListBillVO list billMapper.selectBillList(query); log.info(query bill cost {} ms, System.currentTimeMillis() - start);如果某些接口耗时超过1秒优先看Mapper SQL的EXPLAIN执行计划检查有没有全表扫描。物业系统的数据量远没到需要分库分表的地步把慢查询加上索引性能问题基本就解决了。我把这套源码里最容易拖慢查询的字段都检查过一遍repair表的status、bill表的owner_id、notice表的publish_time都值得建索引。另外数据库连接池参数里maxActive不要设得太大Tomcat默认线程池也就200连接池设50就够了配多了反而会因为空闲连接过多拖慢响应。本文还有配套的精品资源点击获取