企业官网建设流程全解析

简介：面向计算机专业毕业设计与Java项目实战学习者的房屋租赁系统完整项目包，采用SpringBoot后端与Vue前端构建B/S架构，配套MySQL数据库、运行说明和源码，可直接用于毕设、课程设计或期末大作业。系统覆盖管理员与用户两端：管理员可管理用户、房屋信息、预约看房、在线签约及系统配置；用户端包含登录注册、房源浏览、资讯查看、交流论坛和个人中心，功能链路较完整，便于理解前后端分离项目的接口设计与权限划分。压缩包共1752个文件，约42.01MB，主要包含Java源码、Vue组件、HTML/CSS/JS静态资源、XML与YML配置、SQL数据库脚本以及编译后的class文件等，目录结构较清晰，方便按模块查阅和二次修改。已有1590人学习下载。项目经调试可运行，附带数据库与部署说明，读者可据此快速还原环境、梳理业务模块、对照源码理解租赁平台的核心流程，也可作为答辩演示和功能扩展的基础工程。

1. 我见过不少人拿到一套房屋租赁源码，第一件事就是找启动类点运行，然后对着一屏红字发呆。761 这套是源码、运行说明、数据库三件套，看着省事，卡人的地方全在环境版本上：同一份包，有人在 JDK 8 下十分钟跑通，有人装了 JDK 17 一启动就报类找不到；有人数据库导完能登录，有人导完房源列表一片空白。这类毕业设计系统代码本身通常没毛病，坑都在三个连接点上——JDK 与框架版本、MySQL 的字符集和时区、前后端接口地址。它适合要完整复现一套房屋租赁前后端加数据库环境、准备演示答辩，或者把系统迁到另一台机器上跑的人。后面按环境、数据库、后端、前端、排错、验收的顺序走一遍。

2. 环境准备：从源码目录倒推 JDK、MySQL 与 Node 的版本

拿到包先别急着下安装包。这套源码的版本要求写在两个文件里：后端是pom.xml，前端是package.json。它们比运行说明里的版本建议更可靠，因为运行说明经常是作者早期写的，作者自己升级过依赖却忘了改文档。按下面顺序看一遍，你就知道该装什么。

2.1 先翻 pom.xml 和 package.json，不要凭感觉装

源码根目录通常一个后端工程、一个前端工程、一个 sql 目录。先确认结构：

# 在源码根目录执行，看清有几个子目录 ls -la # 进后端目录，从 pom.xml 里抽四类关键信息 cd house-rental-server grep -n -E "spring-boot-starter-parent|<java.version>|maven.compiler|artifactId>mysql-connector" pom.xml

这段 grep 输出的四行信息分别决定四件事：spring-boot-starter-parent的版本决定 Spring Boot 大版本，2.x 用的是javax.servlet，3.x 换成了jakarta.servlet，对应的 JDK 基线一个是 8、一个是 17；<java.version>是最直接的 JDK 信号，写 1.8 就别用 17 去跑；maven.compiler.source/target决定编译级别，和上一项冲突时要以后者为准改 pom；mysql-connector的 artifactId 决定驱动类名，5.1.x 是com.mysql.jdbc.Driver，8.x 是com.mysql.cj.jdbc.Driver。

前端同样先看声明：

cd ../house-rental-web grep -n -E "\"node\"|\"node-sass\"|\"sass\"|\"vue\"|\"webpack\"" package.json

重点看node-sass这一项。只要它出现，Node 版本就不能随便升。node-sass 4.x 对应 Node 14，5.x 对应 Node 16，再往上装必然编译失败，报Node Sass could not find a binding for your current environment。换成 dart-sass 要改依赖和引用路径，演示场景下切 Node 版本更省事。

注意：源码包里如果带了target、node_modules、.idea、.vscode，先删干净再编译。target里的旧 class 会让 Maven 增量构建跳过你改过的代码，排查半天发现是编译产物在骗人。

2.2 版本对照表：JDK、MySQL、Maven、Node 怎么选

下表是针对房屋租赁这类 Spring Boot + 前端工程常见的稳妥组合，具体仍以 2.1 抽出的信息为准：

JDK 为什么优先 8：Spring Boot 2.x 的反射和字节码增强在 17 上会遇到模块访问限制，一些老版本 Lombok 直接崩掉；JDK 11 大多能跑，但部分依赖用了被移除的javax.xml.bind，要手动补包，对第一次搭建的人来说没必要增加这个变量。看本机装了哪些：

# macOS / Linux 看已安装的 JDK 列表 /usr/libexec/java_home -V # 任意平台看当前生效版本 java -version 2>&1 | head -n 1 echo $JAVA_HOME

多版本切换靠JAVA_HOME指向对应目录，改完重开终端再验一次，环境变量没刷新是新手最常见的“我明明改了”。

MySQL 这一项值得多说两句。5.7 和 8.0 的差异不只是性能：8.0 默认排序规则是utf8mb4_0900_ai_ci，5.7 导出脚本常带utf8mb4_general_ci。从高版本往低版本导，直接报Unknown collation；反过来一般没事，8.0 认general_ci。驱动方面，pom 里锁死 5.1.x 而服务端是 8.0 时，8.0 默认的caching_sha2_password认证插件会连不上，需要在连接串里补allowPublicKeyRetrieval=true。这套组合我在实验室机器上翻过车，最后是把驱动升到 8.x 才消停。

Maven 3.8 之后对 http 仓库的限制更严，会报 blocked mirror。如果你的依赖来自内网 http 源，装 3.6.3 会少一层折腾。Node 的取舍前面已经说过，这里补一句：Node 14 已经不更新了，只在本地演示环境用；要长期维护，还是把 node-sass 换掉。

2.3 目录结构和运行说明该按什么顺序读

一份典型的交付目录长这样：

761-house-rental/ ├── sql/ │ └── house_rental.sql # 建库建表 + 初始化数据 ├── house-rental-server/ # 后端 Maven 工程 │ ├── pom.xml │ └── src/main/resources/application.yml ├── house-rental-web/ # 前端工程 │ ├── package.json │ └── .env.development └── 运行说明.txt

阅读顺序建议是：先 sql 再看配置，最后看运行说明。sql 决定库名和表数量，application.yml 决定端口、连接、上传路径，前端.env.development或src/utils/request.js决定接口地址。这三样对上了，运行说明基本只剩“先启动后端再启动前端”这种通用提示。

运行说明的通病有三个：写死作者本机的绝对路径（D:/upload/、/Users/xxx/）、写死作者自己的数据库密码、截图是旧版本界面。凡是出现盘符或者用户目录的路径，一律换成你机器上真实存在的目录；密码一律重设。把这三处当成“需要替换的占位符”而不是“照抄的配置”，能省掉一半的启动失败。

3. 数据库先配置：sql 导入、字符集与连接串参数

很多教程把数据库放到最后，我习惯反过来。后端启动第一件事就是连库，库没搞定，日志里全是连接异常，其他错误全被盖住，等于白启动。这一章的目标是：导入完成后，你用命令行能查到房源表，用应用账号能连上。

3.1 建库：字符集和排序规则一次定对

先确认脚本里有没有建库语句，避免重复建库报错：

# 有输出说明脚本自带 CREATE DATABASE 或 USE，直接导入即可 grep -n -i -E "create database|^use " sql/house_rental.sql

没有就自己建，字符集和排序规则按脚本里建表语句对齐：

CREATE DATABASE `house_rental` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

utf8mb4不是可选项。房源描述、评论、用户昵称里一旦出现 emoji 或生僻字，三字节的utf8存不下，轻则截断重则报Incorrect string value。排序规则要先看一眼脚本用的哪种：

# 统计脚本里出现的排序规则，出现 0900_ai_ci 说明来自 MySQL 8.0 grep -o -i "collate[ =][a-z0-9_]*" sql/house_rental.sql | sort | uniq -c

输出里有utf8mb4_0900_ai_ci，你的库又是 5.7，就必须在导入前替换，否则建表直接失败。顺手确认存储引擎：

grep -c "ENGINE=InnoDB" sql/house_rental.sql

如果脚本里混了 MyISAM 表，下单、审核这类带事务的逻辑会出现半截写入，而且不是每次都复现，属于最难查的那类问题。能改就统一成 InnoDB。

3.2 导入 sql：编码、顺序与外键

导入命令本身简单，参数不能省：

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

--default-character-set=utf8mb4是关键。不加的话客户端连接可能按 latin1 或 gbk 解释，中文在写入那一刻就坏了，事后改连接串也救不回来，只能重建库重导。这一步翻车的人不少，属于典型的血泪经验。

导入过程中的三类报错和对应处理：

ERROR 1273 (HY000): Unknown collation: 'utf8mb4_0900_ai_ci'，原因是脚本来自 8.0 而库是 5.7。替换后重导：

# macOS 上 sed -i 需要写成 sed -i ''，Linux 直接 -i sed -i "s/utf8mb4_0900_ai_ci/utf8mb4_general_ci/g" sql/house_rental.sql

ERROR 1215 (HY000): Cannot add foreign key constraint，多半是建表顺序问题，子表排在父表前面。确认脚本开头有SET FOREIGN_KEY_CHECKS=0;，结尾再置回 1；没有就手动加，或者按依赖顺序拆开导。

ERROR 1452 (23000): Cannot add or update a child row，初始化数据里的外键指向了不存在的记录。先只导表结构，把应用跑起来看业务是否正常，再决定要不要补初始化数据。

导完核对表数量，别只看客户端没报错：

USE house_rental; SHOW TABLES; SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = 'house_rental';

数量和运行说明里描述的一致才算导完。少一张通常是脚本中途断了而客户端把错误吞了，换命令行重导一遍更稳。

3.3 连接串：四个参数决定后端连不连得上

后端配置里这一行最容易写错，拆开看每个参数：

spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/house_rental?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: house_app password: 换成你自己的密码

driver-class-name要和 pom 里的 connector 版本对应。Spring Boot 2.x 一般能自动推断，但显式写清楚，出问题时少一个怀疑对象。serverTimezone写Asia/Shanghai而不是GMT%2B8，后者在部分版本里解析行为不一致。

3.4 建独立账号，别拿 root 跑应用

root 连库能跑，但演示时容易出事：同学或同事拿你的环境点两下，一次误删就没了。

CREATE USER 'house_app'@'localhost' IDENTIFIED BY '换成强密码'; GRANT SELECT, INSERT, UPDATE, DELETE ON house_rental.* TO 'house_app'@'localhost'; FLUSH PRIVILEGES;

只给增删改查，不给DROP、ALTER。这是给自己留后悔药。确有必要建表的场景再补CREATE。远程连接把localhost换成具体网段，不要图省事写%，尤其别写在实验室的公共机器上。

验证账号可用：

mysql -u house_app -p -h 127.0.0.1 house_rental -e "SELECT COUNT(*) FROM house;"

能查出行数，数据库这一关就算过了。

4. 后端跑通：配置改四处、Maven 编译、启动看三行日志

后端从“能编译”到“能对外服务”中间隔着几步，每一步都有明确的判断标准。这部分我一般按配置、编译、启动、前端联调的顺序推进，任何一步没过就不往下走。

4.1 application.yml 里必须改的四个键

配置文件里和本机相关的键有四处，改完才算对齐环境：

server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/house_rental?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: house_app password: 换成你自己的密码 servlet: multipart: max-file-size: 10MB max-request-size: 20MB app: upload-path: /data/house-rental/upload/

第一处是连接信息，第二章已经说过；第二处是端口，和前端代理要对上；第三处是上传大小限制，房源图片动辄几 MB，默认 1MB 会直接报MaxUploadSizeExceededException；第四处是上传落盘目录，必须用绝对路径且真实存在。

upload-path是这套系统里最容易忽略的一项。作者在自己机器上写的是D:/upload/之类，你拿到 Linux 上必然找不到目录。启动前手动建好并给权限：

sudo mkdir -p /data/house-rental/upload sudo chown -R $(whoami) /data/house-rental/upload

路径统一用正斜杠，Windows 下的反斜杠要么转义要么改掉，配置文件里混用两种分隔符是另一个人为坑。

4.2 Maven 编译：先跳测试，再看三个报错

编译命令加一个参数，先跳过测试类：

mvn -v mvn clean package -DskipTests

-DskipTests只跳过执行、不跳过编译，这是它和-Dmaven.test.skip=true的区别。测试类常常依赖外部环境（写库、调接口），第一次跑很容易失败，先让主工程过，跑通应用后再回头补。

三类常见编译错误：

无效的源发行版: 17，pom 里写的是 1.8，你本地用 JDK 17 编译。切回 JDK 8 比改 pom 安全，改 pom 可能连带影响依赖的字节码版本。

找不到符号: 方法 getXxx()，Lombok 没生效。检查 IDE 是否装了 Lombok 插件，以及 pom 里 Lombok 版本是否和 JDK 匹配，老版本在 JDK 11 以上会有兼容问题。

依赖下载中断或超时，配置镜像。settings.xml 里加一段：

<mirrors> <mirror> <id>internal-mirror</id> <mirrorOf>central</mirrorOf> <url>https://你的内网仓库地址/repository/public</url> </mirror> </mirrors>

mirrorOf写central表示代理中央仓库。地址问运维要，不要随手抄网上的公开源，时快时慢，中途断掉会在本地.m2/repository留下.lastUpdated文件，下次编译直接报错。删掉对应目录下的*.lastUpdated再重试即可。

4.3 启动：看三行日志判断是否真的起来了

打包成功后启动：

java -jar target/house-rental-0.0.1-SNAPSHOT.jar

启动成功的标志不是“没有报错”，而是三行日志依次出现：数据源初始化完成、Tomcat started on port(s): 8080、Started XxxApplication in x seconds。只看到前两行就说明数据源还在重试，后面大概率跟着连接超时。

端口被占是最常见的中断原因：

# Linux / macOS lsof -i :8080 # Windows netstat -ano | findstr :8080

Spring Boot 遇到端口占用会直接退出，日志里只有一行Port 8080 was already in use，滚动太快容易被后面的堆栈掩盖。临时换端口启动：

java -jar target/house-rental-0.0.1-SNAPSHOT.jar --server.port=8081

命令行参数优先级高于配置文件，适合临时验证，验证完记得改回去，否则前端代理指向 8080 又会找不到后端。

4.4 前端联调：node 版本、依赖安装和接口地址

前端三步走：

cd house-rental-web node -v # 确认是 14.x 或 16.x npm install npm run serve

npm install阶段报 gyp 编译错误，基本是 node-sass 和 Node 版本不匹配。用 nvm 切版本最直接：

nvm install 14.21.3 nvm use 14.21.3 rm -rf node_modules package-lock.json npm install

删掉package-lock.json是因为它锁定了旧版本解析结果，不删的话重装还是同一套依赖。

接口地址在src/utils/request.js或.env.development里：

// src/utils/request.js const service = axios.create({ baseURL: process.env.VUE_APP_BASE_API || 'http://127.0.0.1:8080', timeout: 15000 })

baseURL必须和后端实际端口一致。开发环境更推荐用代理避免跨域：

// vue.config.js devServer: { proxy: { '/api': { target: 'http://127.0.0.1:8080', changeOrigin: true } } }

changeOrigin: true会把请求头里的 Host 改成目标地址，有些做了来源校验的接口必须开。代理前缀/api要和后端 Controller 的@RequestMapping前缀对得上，对不上就是一片 404，看着像后端没启动，其实请求根本没转发过去。

5. 排查记录：这套房屋租赁源码最容易出问题的五个部分

下面五条是这类项目里复现率最高的，每条按现象、原因、解决写，遇到问题可以直接对照。

5.1 登录一直转圈，控制台不报错

现象：点登录按钮后请求长时间 pending，Network 面板里请求已发出但迟迟不返回，偶尔超时。

原因：前端baseURL指向的端口没有后端在监听，或者本机启动了多个后端实例，前端连到了旧的那个；另一种是接口前缀重复，实际路径变成/api/api/login。

解决：先在浏览器地址栏直接访问baseURL + 接口路径，返回 JSON 说明后端正常，问题在前端配置；返回 HTML 错误页说明路径不对。再核对 Controller 的映射前缀和request.js里的baseURL，最后把多余的 java 进程关掉，只留一个。

5.2 房源标题和评论变成问号

现象：数据库客户端里查出来是????，页面显示同样异常。

原因：建库时字符集不是utf8mb4，或者导入时没带--default-character-set=utf8mb4，中文在写入那一刻已经被转换成坏数据，事后改连接串、改配置都救不回来。

解决：SHOW CREATE TABLE house;看CHARSET是否为utf8mb4，不是就删库重建、重新导入，导入命令必须带编码参数。已经产生的脏数据只能重新录入，这也是为什么字符集要在建库时一次定对。

5.3 上传房源图片报 500

现象：图片选择后提交，后端抛FileNotFoundException或AccessDeniedException。

原因：upload-path沿用了作者机器上的路径，你本机没有这个目录；Linux 下还有目录属主和权限问题。

解决：换成你机器上真实存在的绝对路径，启动前手动创建并确认当前用户有写权限。生产环境把上传目录挂到独立数据盘，别放在项目目录下，重新部署会连文件一起覆盖。代码里最好补一句启动时自动mkdirs，省得换机器再踩一次。

5.4 启动报 Table doesn't exist，客户端里明明有

现象：数据库客户端能看到表，应用启动或查询时报表不存在。

原因：连接串里的库名写错，连到了另一个同名表结构的库；或者 Linux 上lower_case_table_names=0，sql 里建的是House，代码里查house，大小写不匹配。

解决：先核对url里的库名，再用SHOW VARIABLES LIKE 'lower_case_table_names';确认大小写策略。Linux 环境下表名统一小写，别在开发和部署之间混用大小写。

5.5 新增记录的时间差 8 小时

现象：数据库里的create_time比实际时间早或晚 8 小时，列表页显示也偏。

原因：连接串没写serverTimezone，MySQL 按 UTC 处理；或者写了UTC而服务器在东八区。

解决：统一serverTimezone=Asia/Shanghai，同时确认数据库全局时区和代码里取时间的方式是否一致。new Date()和DEFAULT CURRENT_TIMESTAMP混用是另一个来源，检查建表语句里的默认值，能统一就统一。

6. 验收走一遍：从登录到下一单，别只看首页能不能打开

首页能出图不代表装好了。我判断一套房屋租赁系统是否真正跑通的标准是“完整业务链路走一遍”，因为首页只调一个列表接口，很多问题在这条链路上根本暴露不出来。

先把后端接口探活，只输出状态码，快：

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/api/house/list

返回200说明服务在、路径对；返回404是前缀不匹配；返回000是端口没监听。这一步比在浏览器里刷页面快得多，排错时先用它定位是前端问题还是后端问题。

然后按角色走流程：管理员账号登录，进用户管理看列表是否分页正常；切换到房东账号发布一套房源，填标题、价格、面积，上传两张图片后提交；回到管理员

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