企业官网建设流程全解析

简介：这是一套面向计算机专业本科生的高分毕业设计级小区物业管理系统实战项目，采用SpringBoot后端与Vue前端技术栈，专为毕设开发、课程大作业及Java全栈入门实践打造。系统覆盖业主管理、物业缴费、报修工单、公告发布等核心业务模块，代码经导师审核与本地完整编译验证，评审得分98分，具备良好的工程规范性与可运行性。资源包共1066个文件，含45个Java后端逻辑类、202个Vue组件JS脚本、342个CSS样式文件、242个PNG界面图标及45个SQL数据库脚本，辅以YML配置、HTML模板与LESS/SCSS样式源码，整体压缩后仅16.86MB，轻量易部署。目前已有105人学习下载，配套数据库完整、目录结构清晰、注释充分，特别适合零基础学员理解前后端分离架构、快速搭建可演示的毕设原型并掌握调试排错关键路径。

1. 这不是又一个“Hello World”管理后台：一套能真正在小区物业现场跑通的 SpringBoot + Vue 全栈系统（含可直接导入的 MySQL 数据库）

你见过多少毕业设计项目，答辩前一晚还在改@Autowired报空指针？部署到服务器上发现 Vue 路由刷新 404，Nginx 配置改了八遍还是跳转不到 login 页面？数据库表字段命名全是user_name和userPassword混用，连基本的驼峰一致性都崩了？这套「基于 SpringBoot + Vue 的小区物业管理系统」不是模板拼凑的 Demo，而是一套我去年帮三个学院学生调试过、最终全部高分通过、且有真实物业管理员试用反馈的闭环落地系统。它覆盖了门禁通行记录查询、报修工单全流程（提交→派单→处理→评价）、收费账单生成与微信支付对接（模拟）、公告发布与楼栋定向推送、业主信息分级管理（含房产证号脱敏展示）等 7 类高频业务场景；后端用 SpringBoot 2.7.18（非最新但稳定兼容 JDK8/11），前端用 Vue 2.6.14 + Element UI（不折腾 Composition API，降低答辩翻车概率）；最关键的是——它附带一份结构完整、含 12 张业务表、已预置测试数据（3 个楼栋、28 户业主、5 名员工）的 MySQL 5.7 数据库脚本，CREATE TABLE语句里每个外键约束、索引、默认值都经实测验证，不是那种导进去就ERROR 1005的“理论脚本”。适合 Java 初学者练手、毕设刚需者快速搭建、甚至小型物业服务商做原型验证——只要你需要一个能编译、能登录、能增删改查、能导出 PDF 报表、且代码注释写在关键逻辑行上的真实系统，它就是那个少走三天弯路的起点。

2. 从零启动：SpringBoot 后端服务搭建与数据库初始化（含 12 张表建模逻辑说明）

2.1 为什么选 SpringBoot 2.7.18 而不是 3.x？——版本选型的血泪经验

很多同学一上来就拉 Spring Initializr 选最新版，结果发现 MyBatis-Plus 3.5.x 和 SpringBoot 3.x 的 Jakarta EE 9 依赖冲突，javax.servlet全报红；或者 Lombok 在 JDK17 下@Data生成的toString()突然抛StackOverflowError。这套系统锁定SpringBoot 2.7.18，原因很实在：

• 它是 SpringBoot 2.x 最终维护版，官方安全补丁持续到 2023 年底，足够应付毕设周期；
• 完美兼容 MyBatis-Plus 3.4.3.4（本项目所用），该版本对@TableField(fill = FieldFill.INSERT)自动填充支持最稳，避免手动写create_time；
• 内置 Tomcat 9.0.83，对application.yml中server.port=8081、server.servlet.context-path=/property的解析无歧义，不会像某些 3.x 版本那样把 context-path 当成路径前缀再拼一次；
• 关键点：它能直接运行在 IDEA 2021.3 及以上版本（不用升级 IDE），而很多学校机房还卡在 2021.1。

提示：如果你本地 JDK 是 17，别慌——SpringBoot 2.7.x 默认支持 JDK17，但需在pom.xml中显式声明<java.version>17</java.version>，否则 Maven 编译会降级到 JDK8 字节码。

2.2 数据库脚本执行：不只是source xxx.sql，而是理解每张表存在的业务理由

项目附带的property_db_init.sql不是简单堆砌CREATE TABLE。它按业务域分组建模，12 张表之间有明确的主外键链路。以下是核心表设计逻辑（非照抄 ER 图，而是告诉你“为什么这么建”）：

执行脚本前，请确认你的 MySQL 服务已启动，字符集为utf8mb4（不是utf8！否则 emoji 和部分中文生僻字存不进t_notice.content字段）。在命令行执行：

mysql -u root -p --default-character-set=utf8mb4 < property_db_init.sql

注意：--default-character-set=utf8mb4参数必须显式指定，否则即使数据库建表时写了CHARSET=utf8mb4，source命令仍可能用默认latin1解析，导致中文变??。

2.3 后端模块划分：为什么 Controller 层要拆成OwnerController而不是PropertyController？

项目采用清晰的 RESTful 分层：

• com.example.property.controller.OwnerController：只处理业主信息 CRUD，URL 路径为/api/owner；
• com.example.property.controller.RepairOrderController：只管报修单，路径/api/repair；
• com.example.property.service.impl.RepairOrderServiceImpl：实现类里@Transactional注解加在submitOrder()方法上，而非整个类——因为只有提交动作需要事务，查询列表不需要。

这种拆法不是为了炫技，而是解决两个现实问题：

1. 答辩演示时快速定位：老师说“让我看看报修单怎么提交”，你直接打开RepairOrderController.java，3 秒内找到@PostMapping("/submit")方法，比在 200 行的PropertyController里 Ctrl+F “submit” 高效得多；
2. 避免循环依赖：RepairOrderService需调用OwnerService查询业主电话，若全塞进一个 Service，极易出现AService依赖BService，BService又依赖AService的死锁。分模块后，依赖关系变成单向箭头：RepairOrderService → OwnerService。

3. Vue 前端工程配置与路由打通：告别Cannot GET /xxx的 404 黑匣子

3.1 Vue 2.6.14 + Element UI 的环境配置：为什么不用 Vue CLI 5.x？

Vue CLI 5.x 默认生成 Vue 3 项目，而本系统前端逻辑重度依赖 Element UI 2.x（如el-table的:span-method合并单元格、el-upload的before-upload文件校验），这些 API 在 Vue 3 的 Element Plus 中已重构。强行升级会导致：

• 所有表格列合并逻辑失效；
• 文件上传组件无法拦截.jpg以外的类型；
• this.$message.success()全部报undefined（Vue 3 的app.config.globalProperties注册方式不同）。

正确做法：用 Vue CLI 4.5.15（支持 Vue 2 最后稳定版）创建项目：

npm install -g @vue/cli@4.5.15 vue create property-vue # 选择 Manually select features → Choose Vue version: 2.x → CSS Pre-processors: Sass → Linter: ESLint + Standard

然后在package.json中锁定关键依赖：

"dependencies": { "vue": "2.6.14", "element-ui": "2.15.14", "axios": "0.21.4", "js-cookie": "2.2.1" }, "devDependencies": { "@vue/cli-service": "4.5.15" }

注意：axios 0.21.4是最后一个兼容 Vue 2 的大版本，0.22.x 开始要求 Promise.finally()，IE11 直接跪；js-cookie 2.2.1支持expires设置为 Date 对象，用于保存登录态 7 天，比 localStorage 更安全。

3.2 路由配置：mode: 'history'的真相与 Nginx 代理的必填项

src/router/index.js中：

export default new Router({ mode: 'history', // 关键！启用 HTML5 History 模式 base: process.env.BASE_URL, routes: [ { path: '/', redirect: '/login' }, { path: '/login', component: () => import('@/views/Login.vue') }, { path: '/home', component: () => import('@/views/Home.vue'), children: [ { path: 'dashboard', component: () => import('@/views/dashboard/Dashboard.vue') }, { path: 'repair', component: () => import('@/views/repair/RepairList.vue') } ] } ] })

mode: 'history'让 URL 看起来干净（/home/repair而非/#/home/repair），但代价是：开发时npm run serve没问题，打包后丢到 Nginx 就 404。原因？History 模式下，浏览器访问/home/repair，Nginx 会去找dist/home/repair/index.html，但实际文件只在dist/index.html。解决方案是在nginx.conf中加：

location / { try_files $uri $uri/ /index.html; }

这行配置的意思是：“如果请求的文件不存在，就返回index.html，让 Vue Router 自己解析路径”。没有它，所有二级路由（如/home/repair）都会 404。

3.3 登录态持久化：为什么用js-cookie而不是localStorage？

Login.vue中登录成功后：

this.$cookies.set('token', res.data.token, { expires: '7d', path: '/' }) // 而不是 localStorage.setItem('token', res.data.token)

原因有三：

• 自动过期：expires: '7d'7 天后 Cookie 自动删除，localStorage需手动写setTimeout清理，极易遗漏；
• 路径控制：path: '/'保证所有页面都能读取，而localStorage是域名级，无路径概念；
• 安全性：Cookie 可设HttpOnly（后端响应头中设置），防止 XSS 窃取，localStorage完全暴露在 JS 环境中。

后端LoginController返回 token 时，必须在响应头中加：

response.addHeader("Set-Cookie", "token=" + jwtToken + "; Path=/; HttpOnly; Max-Age=604800");

注意：Max-Age=604800（7 天秒数）比Expires更可靠，不受客户端时间篡改影响。

4. 前后端联调避坑指南：那些让你凌晨三点还在查日志的典型故障

4.1 现象：Vue 页面点击“提交报修”按钮，Network 显示500 Internal Server Error，后端日志却空空如也

原因：前端axios请求未携带Content-Type: application/json，后端@RequestBody RepairOrder order无法反序列化，SpringBoot 默认返回白页 500，且不打印异常堆栈（因@RestControllerAdvice未捕获HttpMessageNotReadableException）。
解决：在src/utils/request.js中全局设置：

service.defaults.headers['Content-Type'] = 'application/json;charset=utf-8' // 并确保所有 POST 请求用 JSON 格式传参 axios.post('/api/repair/submit', { title: '门禁失灵', content: '1号楼东侧门禁刷卡无反应' })

4.2 现象：业主列表页显示undefined，F12 查看 Network，/api/owner/list返回数据正常，但 Vue 组件v-for="owner in ownerList"渲染为空

原因：ownerList在data()中定义为[]，但mounted()里调用this.getOwnerList()时，this指向错误（常见于箭头函数误用或async/await未 await）。
解决：检查methods中方法是否用了箭头函数：

// ❌ 错误：箭头函数导致 this 指向丢失 getOwnerList: () => { axios.get('/api/owner/list').then(res => { this.ownerList = res.data // this 不是 Vue 实例！ }) } // ✅ 正确：普通函数，this 指向 Vue 实例 getOwnerList() { axios.get('/api/owner/list').then(res => { this.ownerList = res.data }) }

4.3 现象：修改业主信息后点击“保存”，接口返回 200，但页面数据没更新，刷新后才看到新值

原因：Vue 的响应式系统对数组/对象的深层属性变更不敏感。ownerList是数组，直接ownerList[0].name = '新名字'不触发视图更新。
解决：用Vue.set或this.$set：

// ✅ 正确：强制触发响应式更新 this.$set(this.ownerList, index, updatedOwner) // 或者用数组的 splice 替换 this.ownerList.splice(index, 1, updatedOwner)

4.4 现象：Nginx 部署后，登录成功跳转/home，但页面空白，Console 报Failed to load resource: the server responded with a status of 404 ()

原因：Vue 打包后index.html中引用的 JS/CSS 路径是相对路径（如js/app.abc123.js），Nginx 配置了location / { try_files $uri $uri/ /index.html; }，但未设置root指向dist目录。
解决：Nginx 配置必须包含：

server { listen 80; server_name your-domain.com; root /var/www/property-vue/dist; # 关键！指定 dist 目录为根目录 index index.html; location / { try_files $uri $uri/ /index.html; } location /api { proxy_pass http://localhost:8081; # 代理到 SpringBoot 后端 proxy_set_header Host $host; } }

4.5 现象：MySQL 导入property_db_init.sql时报错ERROR 1005: Can't create table 'property.t_repair_order' (errno: 150 "Foreign key constraint is incorrectly formed")

原因：外键字段类型不一致。例如t_repair_order.assignee_id是BIGINT，但t_staff.id是INT，或两者字符集不同（一个utf8mb4，一个utf8）。
解决：逐个检查外键字段：

-- 查看 t_staff.id 字段类型 SHOW CREATE TABLE t_staff; -- 查看 t_repair_order.assignee_id 字段类型 SHOW CREATE TABLE t_repair_order; -- 确保两者完全一致：类型（INT/BIGINT）、符号（UNSIGNED）、字符集（utf8mb4）、排序规则（utf8mb4_0900_ai_ci）

修复后重新建表：

ALTER TABLE t_repair_order DROP FOREIGN KEY fk_assignee; ALTER TABLE t_repair_order MODIFY assignee_id BIGINT UNSIGNED; ALTER TABLE t_repair_order ADD CONSTRAINT fk_assignee FOREIGN KEY (assignee_id) REFERENCES t_staff(id);

5. 数据库增删改查实战：用 MyBatis-Plus 快速实现业主信息管理（含分页与条件查询）

5.1 MyBatis-Plus 代码生成器：3 分钟生成全套 CRUD，但必须改这 3 处

项目使用mybatis-plus-generator自动生成 Entity、Mapper、Service、Controller。生成后务必手动修改：

1. Entity 类中的@TableId：t_owner.id是自增主键，但生成器默认用@TableId(type = IdType.ASSIGN_ID)（雪花算法），需改为：

   @TableId(type = IdType.AUTO) // 让 MySQL 自增 private Long id;

2. Mapper 继承BaseMapper<Owner>后，添加自定义 SQL：MyBatis-Plus 的selectList()无法处理多表关联，如查业主及其所在楼栋名称，需在OwnerMapper.java中加：

   @Select("SELECT o.*, b.building_name FROM t_owner o LEFT JOIN t_building b ON o.building_id = b.id WHERE o.status = 1") List<OwnerWithBuilding> selectOwnerWithBuilding();

   并定义OwnerWithBuildingVO 类，避免@TableName注解污染主 Entity。
3. ServiceImpl 中的save()方法：MyBatis-Plus 的save()不校验重复，需在OwnerServiceImpl.java中重写：

   @Override public boolean save(Owner owner) { // 校验身份证号是否已存在 QueryWrapper<Owner> wrapper = new QueryWrapper<>(); wrapper.eq("id_card", owner.getIdCard()); if (count(wrapper) > 0) { throw new RuntimeException("身份证号已存在"); } return super.save(owner); }

5.2 条件分页查询：QueryWrapper的链式调用与防 SQL 注入

OwnerController.java中的列表接口：

@GetMapping("/list") public Result list( @RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, @RequestParam(required = false) String name, @RequestParam(required = false) String buildingNo) { Page<Owner> page = new Page<>(current, size); QueryWrapper<Owner> wrapper = new QueryWrapper<>(); // ✅ 安全：字符串参数用 like，且前后加 %，MyBatis-Plus 自动转义 if (StringUtils.isNotBlank(name)) { wrapper.like("name", name); // 生成 WHERE name LIKE '%张%' } if (StringUtils.isNotBlank(buildingNo)) { wrapper.eq("building_no", buildingNo); // 生成 WHERE building_no = '1号楼' } // ✅ 防注入：数值参数直接 eq，不拼 SQL wrapper.eq("status", 1); // 有效业主 Page<Owner> resultPage = ownerService.page(page, wrapper); return Result.success(resultPage); }

注意：wrapper.like("name", name)中的name是变量，不是字符串拼接，MyBatis-Plus 底层用?占位符，杜绝 SQL 注入。切忌写成wrapper.apply("name LIKE '%" + name + "%'")。

5.3 批量导入业主：Excel 解析与事务回滚边界

OwnerController.java提供/import接口，接收 Excel 文件。关键点在于：

• 使用Apache POI解析，但禁止在循环中逐条save()（100 条数据会发 100 次 SQL，超时）；
• 改用saveBatch()，但需注意：事务边界必须包裹整个批量操作，否则某条失败，前面成功的不会回滚。

实现如下：

@PostMapping("/import") @Transactional(rollbackFor = Exception.class) // 整个方法加事务 public Result importOwners(@RequestParam MultipartFile file) { List<Owner> owners = parseExcel(file); // 解析 Excel 到 List // 校验数据合法性（如身份证格式、楼栋是否存在） for (Owner owner : owners) { if (!IdCardUtil.isValid(owner.getIdCard())) { return Result.fail("第" + (owners.indexOf(owner)+1) + "行身份证格式错误"); } } // 批量保存，失败则全部回滚 boolean success = ownerService.saveBatch(owners, 100); // 每批 100 条 return success ? Result.success() : Result.fail("导入失败"); }

血泪经验：saveBatch()的batchSize参数设为 100 是经验值，太大（如 1000）易 OOM，太小（如 10）性能差。线上环境建议压测确定最优值。

6. 毕设答辩加分技巧：如何用这套系统讲出“工程能力”而非“复制粘贴”

6.1 答辩演示时，刻意暴露一个“可控缺陷”并当场修复

别把系统包装成完美无瑕的玩具。我在指导学生时，会让他们在答辩前，在RepairOrderController.submitOrder()方法里故意注释掉一行关键校验：

// TODO: 此处应校验报修内容长度，暂移除以演示调试过程 // if (order.getContent().length() < 10) { // return Result.fail("报修内容不得少于10个字"); // }

然后演示时，输入一个 3 字的报修标题（如“坏了”），点击提交——弹出后端返回的500错误。接着打开 IDEA，取消注释，重新编译，刷新页面，再次提交成功。这个过程传递三个信号：

• 你理解业务规则（内容长度校验是合理需求）；
• 你掌握调试手段（看 Network、查日志、定位代码）；
• 你有工程意识（TODO 是主动留痕，不是偷懒）。

6.2 数据库设计汇报：用一张表讲清“范式”与“反范式”的权衡

不要背诵“第三范式要求消除传递依赖”。直接打开t_payment_record表，指着building_no、unit_no、room_no字段说：

“这里存了楼栋、单元、房号，看似冗余（违反范式），但实际是反范式优化。因为缴费查询最高频的条件就是‘查某栋某单元某户的欠费’，如果只存owner_id，每次都要JOIN t_owner，QPS 超 50 就慢。而物业系统并发量低，空间换时间值得。”

再对比t_repair_order表，强调assignee_id存员工 ID 而非姓名——这才是范式：姓名可能改，ID 不变，避免更新异常。

6.3 部署方案陈述：不提 Docker，讲清楚 Nginx 为什么比 Tomcat 直接暴露更安全

很多学生说“我用 Docker 部署”，老师一听就皱眉——Docker 在毕设场景是过度设计。换成务实说法：

“我用 Nginx 作为反向代理，有两个好处：第一，Nginx 处理静态资源（JS/CSS/图片）比 Tomcat 快 3 倍，首页加载从 1.2s 降到 0.4s；第二，Nginx 可以加 IP 白名单，比如只允许物业办公室的 192.168.1.0/24 网段访问后台，Tomcat 做这事要写 Filter，复杂且易出错。”

附上nginx.conf中的真实配置片段，比讲原理更有说服力。

6.4 源码包交付清单：让老师一眼看出你做了多少事

交付的 ZIP 包里，除了代码，必须包含：

• docs/目录：含数据库设计说明书.md（ER 图 + 字段说明）、接口文档.md（Swagger 截图 + curl 示例）、部署手册.md（含 Nginx 配置全文、MySQL 字符集检查命令）；
• test-data/目录：含test_users.xlsx（3 个测试账号：管理员/客服/维修员，密码均为123456），方便老师快速体验；
• screenshots/目录：含 5 张核心页面截图（登录页、业主列表、报修单详情、缴费记录、系统设置），命名规范如01_login_page.png。

从那以后我每次帮学生整理毕设包，都强制走一遍tree -L 2检查目录结构，再用grep -r "TODO" .扫描所有待办项——不是为了消灭 TODO，而是确保每个 TODO 都有上下文注释，让老师看到你思考的痕迹。希望帮到你。

本文还有配套的精品资源，点击获取