简介基于Java Web的房屋租赁管理系统完整源码包面向正在学习Java Web开发的学生或需要完成课程设计、毕业设计的开发者。项目基于Eclipse Tomcat MySQL JDK构建包含房源管理、用户注册登录、租赁合同处理等典型业务模块适合用来理解MVC架构、Servlet与JSP交互以及JDBC数据库操作。压缩包共1804个文件约13.32MB主要文件类型包括119个Java源文件、102个JSP页面、146个CSS样式、195张PNG图片、2个SQL数据库脚本以及若干配置文件其中SQL脚本可直接导入MySQL完成数据库初始化源码中的连接配置可按本地环境修改。目前已有1275人学习下载。借助该资源可快速获得一套可运行的房屋租赁系统原型并对照源码与数据库脚本梳理完整开发流程对提升综合排错与部署能力很有帮助。1. 这套房屋租赁管理系统源码 数据库一起给的 Java Web 实战包很多人下到的课程设计资源要么只有源码没有数据库脚本要么SQL文件导进去全是外键报错能跑起来的少。这套基于 Java Web 的房屋租赁管理系统压缩包里同时给了 Eclipse 工程和数据库脚本Tomcat MySQL 就能把整条链路拉起来属于典型的「能跑、能讲、能答辩」资源。它解决的是信息管理类课设最常见的问题房源信息的增删改查、用户注册登录、租赁合同记录以及这些模块之间怎么通过 Servlet JSP JDBC 串起来。适合正在做 Java 课程设计或毕业设计的学生也想搞明白 Servlet 和 JSP 到底怎么交互、数据库连接放在哪一层的人如果你已经在用 Spring Boot这套资源的定位更适合往回补基础。2. 环境铺平JDK、Tomcat、MySQL 版本选型与验证2.1 技术栈为什么是这套组合这套系统走的是典型的 B/S 结构浏览器发 HTTP 请求Tomcat 作为 Servlet 容器负责接请求把请求交给 Servlet 处理业务逻辑最后由 JSP 渲染页面返回。MySQL 在底层存房源、用户、租赁记录Java 程序通过 JDBC 和 MySQL 通信。四个组件各管一段没有 Spring 全家桶那样的大框架包装每一层都能直接看到代码这恰恰是课程设计和毕设最看重的点——导师问「这块怎么实现的」时你能从 Servlet 的 doPost 一路讲到 SQL 语句而不是甩出一句「框架封装好了」。Eclipse 在这里不只是编辑器还承担了项目的构建和部署职责。你在 Eclipse 里导入工程配置好 Tomcat点 Run As 直接在本地把应用跑起来。不需要额外装 Maven项目依赖的 JDBC 驱动 jar 一般放在 WebContent/WEB-INF/lib 下IDE 会直接加载。对新手来说这一步少了很多 Aur 依赖下载的折腾对熟手来说也能一眼看清项目没有隐藏的黑匣子依赖。2.2 版本匹配与安装验证先说版本对应关系。JDK 8、Tomcat 8.5 或 9.0、MySQL 5.7 或 8.0 是这套技术栈最稳妥的组合。JDK 8 是 Java Web 课程设计的万金油编译器级别低、兼容性最好Tomcat 8.5 对 JDK 8 支持完整Servlet 3.1 规范正好匹配MySQL 5.7 和 8.0 都能用但如果你的 MySQL 是 8.0JDBC 驱动 jar 必须换成mysql-connector-java-8.x这是最常见的翻车点后面第 3 章详细说。环境装完后按下面的顺序做验证java -version mysql -uroot -p # Tomcat 启动Windows 用 startup.batLinux/macOS 用 startup.sh bin/startup.sh第一条命令确认 JDK 能编译运行第二条确认数据库能登录后面导入 SQL 脚本要用第三条把 Tomcat 拉起来浏览器访问http://localhost:8080看到 Tomcat 默认页面就说明 Servlet 容器正常。这里补充一个参数如果 8080 端口被占去 Tomcat 的conf/server.xml里找到Connector port8080 ...把端口改成 8081 或 8082改完重启。我在机房电脑上遇到过一次 8080 被 Oracle 的XDB服务占用的情况当时就是改 port 解决的。还有一个值得强调的是 Tomcat 的版本有些同学装了 Tomcat 10结果发现项目里javax.servlet包全部过时因为 Tomcat 10 换成了jakarta.servlet这类报错说明版本不兼容换成 Tomcat 8.5 或 9 最省事。2.3 导入 Eclipse 前要确认的四个配置从压缩包解压出的工程导入方式和新建项目完全不同。正确操作是File - Import - Existing Projects into Workspace然后选中工程根目录勾选Search for nested projects。导入后不要急着运行先确认以下四项第一工作空间的编码。Window - Preferences - Workspace - Text file encoding选 UTF-8。如果编码不统一你看到的中文注释全是乱码更麻烦的是 JSP 页面里的中文在浏览器里显示成问号。第二项目的 Java Compiler 级别。右键项目进Properties - Java Compiler确认Compiler compliance level和本机 JDK 匹配常见组合是 1.8 对应 JDK 8。第三Server Runtime 里要能看到 Tomcat。Window - Preferences - Server - Runtime Environments里 Add 一个 Tomcat 8.5路径指向你解压的 Tomcat 目录Eclipse 才能把项目发布到容器里。第四检查WebContent/WEB-INF/lib下有没有 MySQL 驱动 jar。如果没有去下载mysql-connector-java-5.1.49.jar或 8.0 版本手动拷进去再右键项目Build Path - Add to Build Path。这一步不做后面启动必报ClassNotFoundException: com.mysql.jdbc.Driver。3. 数据库那条线SQL 脚本执行、JDBC 连接与三个隐蔽参数3.1 SQL 脚本里有什么建表顺序与初始数据资源包里的 SQL 文件夹通常是整个系统的地基。脚本一般先建库再建表插入初始数据。我建议用命令行执行比图形化工具更能看清报错位置mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS house_manager DEFAULT CHARSET utf8mb4; mysql -uroot -p house_manager house_manager.sql第一条命令先建库指定utf8mb4字符集避免中文乱码第二条命令把脚本导入到对应库里。注意house_manager.sql脚本里如果已经有CREATE DATABASE语句那么第二条命令可以不带库名执行这时要用mysql -uroot -p house_manager.sql。建表脚本里典型的用户表长这样CREATE TABLE user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, phone VARCHAR(20), role TINYINT DEFAULT 1 COMMENT 1-租客 2-管理员 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有一个很典型的坑user是 MySQL 的保留字不加反引号直接建表会报语法错误。写脚本的人一般会用反引号把它包起来你自己写 SQL 时也要养成这个习惯否则 MySQL 会把user当成mysql.user那个系统表。除了user表资源里通常还有house房源表和rent租赁合同表。导入时如果脚本里有外键约束要注意执行顺序——先建被引用的表再建引用别人的表也就是house和user先建rent后建。如果你的脚本一次导入报外键错误常见解决方法是把脚本里的CREATE TABLE语句手动拆开按依赖关系分批执行。3.2 JDBC 连接配置在项目里的落点这个项目的数据访问层一般有两种写法一种是把连接参数放在src/db.properties文件里再配合DBUtil.java读取另一种是直接在DBUtil.java里硬编码 URL、用户名和密码。前一种改配置方便后一种源码结构相对简单。我拿到这类资源时会优先找db.propertiesjdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/house_manager?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password123456注意驱动类名MySQL 5.x 用com.mysql.jdbc.DriverMySQL 8.0 必须改成com.mysql.cj.jdbc.Driver。连接串里serverTimezoneAsia/Shanghai是关键参数MySQL 8.0 不写这个参数启动时必报时区错误characterEncodingutf8负责中文字符传输useSSLfalse是关闭本地开发时的 SSL 握手不加的话日志里会有 warning虽然不影响运行但答辩时被问到会很尴尬。如果项目里没有db.properties那就是DBUtil.java硬编码找到getConnection()方法直接改字符串。改完以后这里的用户名、密码必须和本机 MySQL 一致。很多同学把资源里默认的root/123456当成账号直接用结果本地 MySQL 的 root 密码根本不是这个数据库连接失败然后满世界找「为什么连不上数据库」。这一步正确的做法是先用命令行mysql -uroot -p验证自己的账号密码能登录再填到配置文件里。3.3 连接串不写参数会怎样我见过的场景是项目部署好了首页能打开但一提交登录表单就白屏控制台报Communications link failure或者The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。前者是驱动版本和 MySQL 版本不匹配后者是连接串缺少 serverTimezone 参数。这两个坑往往同时出现因为 MySQL 8.0 的驱动强制要求指定时区。另一个隐蔽问题是中文乱码。如果页面输入中文后存进数据库变成??排查顺序是先看 JSP 页面有没有% page contentTypetext/html; charsetUTF-8 %再看连接串有没有characterEncodingutf8最后看数据库表本身的字符集是不是utf8mb4。这三个环节有一个不是 UTF-8中文就保不住。写连接串的时候宁可多写两个参数也别让这些问题在答辩前夜冒出来。4. 核心链路拆解登录到房源管理的 Servlet HouseManager 走查4.1 登录请求是怎么被处理的登录是整个系统的入口也是理解 MVC 在项目里真实形态的最佳样本。浏览器把表单 POST 给一个 Servlet 映射的 URLServlet 在doPost里拿参数、调 DAO、查数据库最后决定跳转还是转发。典型的登录 Servlet 长这样WebServlet(/login) public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDAO dao new UserDAO(); User user dao.findByUsernameAndPassword(username, password); if (user ! null) { request.getSession().setAttribute(loginUser, user); response.sendRedirect(request.getContextPath() /house/list); } else { request.setAttribute(msg, 用户名或密码错误); request.getRequestDispatcher(/login.jsp).forward(request, response); } } }这段代码有三个信息值得注意。第一request.setCharacterEncoding(UTF-8)必须放在最前面否则 POST 过来的中文参数会乱码。第二登录成功后用sendRedirect做重定向配合getContextPath()拿到应用上下文路径这样不管项目部署成什么名字都不会拼错路径登录失败用forward转发回登录页同时带上错误提示。第三Session 里存的是User对象后续 JSP 页面靠session.getAttribute(loginUser)判断用户是否登录。项目里如果资源用的不是注解而是web.xml配置 Servlet 映射实现方式也是等价的区别只在servlet-mapping那段 XML 里。4.2 HouseManager 的增删改查与 SQL 参数传递HouseManager是这套系统里的核心业务处理类负责房源信息的增删改查。这个类里通常写着纯粹的 JDBC 操作每层方法干一件事addHouse插一条房源deleteHouse按 id 删updateHouse改价格和状态queryHouse按条件查。查询方法是最能看出功底的因为要处理可选的关键字和价格区间public ListHouse queryHouse(String keyword, double minPrice, double maxPrice) { StringBuilder sql new StringBuilder(SELECT * FROM house WHERE status 1); if (keyword ! null !keyword.trim().isEmpty()) { sql.append( AND address LIKE ?); } if (minPrice 0) { sql.append( AND price ?); } if (maxPrice 0) { sql.append( AND price ?); } // 按需求追加排序条件 sql.append( ORDER BY publish_time DESC); PreparedStatement ps conn.prepareStatement(sql.toString()); // 按条件个数依次 setString / setDouble }这套写法的核心是动态拼 SQL先拼好固定部分再把可选条件逐个追加最后用PreparedStatement的占位符?传参。为什么要用PreparedStatement而不是Statement直接拼字符串因为参数里如果带了单引号或特殊字符直接拼 SQL 轻则报错重则被撞库注入这是新手最容易忽略的点。参数顺序要和 SQL 里?出现的顺序一致先setString设置关键字再setDouble设置价格区间顺序反了会报参数类型错误。4.3 租赁合同记录与事务控制租赁合同表把user和house关联起来一笔租赁记录对应一个租客、一套房源、起止日期和租金。签合同这个动作有一个隐含的业务规则房源状态要从「可租」改成「已租」。如果把这两步拆成两条独立的 insert 和 update中间任何一步失败数据库里就会出现「房源已经租出去但合同没签上」或「合同签了但房源还在租」的脏数据。正确的做法是把两步包进一个事务Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 手动开启事务 // 1. 向 rent 表插入合同记录 // 2. 更新 house 表的 status 字段为已租 conn.commit(); // 都成功才提交 } catch (Exception e) { if (conn ! null) { conn.rollback(); // 任何一步失败全部回滚 } throw e; } finally { DBUtil.close(conn); }setAutoCommit(false)是事务的开关commit()是确认两组写操作都成功rollback()是出了异常把数据库还原到操作前的状态。这套写法在课程设计里看起来不大但面试和答辩时被问「怎么保证数据一致性」的概率极高。你可以顺着这个点再往深说一层如果把系统优化成生产级可以选择把连接管理交给数据库连接池比如 DBCP 或 HikariCP事务的写法不变但连接获取和释放的方式会正规得多。不过对于当前这套资源直连方式反而更容易把逻辑讲清楚。5. 本地部署与常见问题排查404、乱码、数据库拒绝连接5.1 完整部署步骤与日志定位拿到资源后建议按固定顺序跑一遍先导 SQL 脚本再改数据库连接配置最后启动 Tomcat。顺序反过来会报「表不存在」或「连接失败」。部署时在 Eclipse 里选中项目右键Run As - Run on Server选择已经配置好的 TomcatIDE 会自动完成编译、发布和启动。浏览器访问地址是http://localhost:8080/项目名/这里的项目名是部署上下文路径默认取工程文件夹名。如果首页在根路径下直接访问http://localhost:8080/工程名/即可不用额外加index.jsp。运行期间出问题第一件事不是看浏览器而是看控制台日志。Eclipse 的 Console 窗口会输出 Tomcat 的启动日志如果是手动启动的 Tomcat日志在logs/catalina.out或logs/localhost.日期.log。日志里搜Exception或Caused by定位真正的原因一般不需要超过两行。5.2 现象页面 404项目启动但访问不到这个是最常见的问题。分两种情况一种情况是http://localhost:8080/能打开 Tomcat 默认页面但加项目名后 404说明应用上下文路径不对检查部署的名称和你输入的路径是否一致去 Eclipse 的 Servers 视图双击 Tomcat看Modules标签页里的 Path 是什么。另一种情况是整个项目编译失败状态显示不是 Started通常是因为代码有编译错误或缺少 jar 包CtrlShiftT 搜DBUtil或LoginServlet看类是否存在。5.3 现象控制台中文乱码页面显示问号乱码要从两层看。第一层是 Java 源文件和 JSP 文件的编码检查工作空间编码是否为 UTF-8JSP 头部有没有声明pageEncoding。第二层是运行时的字符集传递POST 请求靠request.setCharacterEncoding(UTF-8)数据库连接靠连接串里的characterEncodingutf8。我的习惯是先把数据从 MySQL 里查出来直接在代码里输出到控制台看 Console 里是不是乱码如果代码里是正常的但页面乱问题出在 JSP 响应编码如果代码里已经乱了问题在数据库连接或表字符集。按这个顺序排查不用瞎猜。5.4 现象Access denied 或 Communications link failure数据库连接失败时日志里最常见的是这两个。Access denied for user rootlocalhost说明账号或密码不对去db.properties检查用户名密码是否和本地 MySQL 一致Communications link failure通常有三种原因MySQL 服务没启动、端口不是 3306、驱动配错。先用命令行mysql -uroot -p试一次确认 MySQL 能登录再SHOW VARIABLES LIKE port;看端口号是不是 3306最后看配置 URL 里写的端口是否一致。如果用的是 MySQL 8.0还要确认驱动 jar 版本和驱动类名都是 8.0 对应的写法。这类排查有个通用的规律——出了问题永远从「日志的第一条 Caused by」开始看不要看最顶上的大段堆栈。堆栈最顶部的异常往往只是表象真正的原因被包在Caused by之后的几行里。把那几行读明白百分之八十的部署问题都能自己解决。6. 进阶给合同表加一个到期提醒接口系统跑通之后可以做一个小而完整的扩展给自己加深印象。租房业务有一个很实际的需求合同快到期了要提前提醒管理员和租客。改造的思路很简单在rent表已有的end_date字段上做一次日期查询把 30 天内到期的合同拉出来。新建一个 Servlet专门处理到期合同查询WebServlet(/contract/expire) public class ContractExpireServlet extends HttpServlet { protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String sql SELECT c.id, h.address, u.username, c.end_date FROM rent c JOIN house h ON c.house_id h.id JOIN user u ON c.user_id u.id WHERE DATEDIFF(c.end_date, CURDATE()) BETWEEN 0 AND 30 ORDER BY c.end_date; // 执行查询把结果放到 request 里转发到 expire_list.jsp } }这段 SQL 里的DATEDIFF(c.end_date, CURDATE())计算合同结束日期和今天之间相差的天数BETWEEN 0 AND 30取 0 到 30 天内的记录也就是说只报已经到期和未来 30 天内到期的合同。JOIN关联出房源地址和租客姓名视图层显示时直接读这几个字段不用再查第二遍数据库。如果想让提醒更自动化可以在项目启动时用ServletContextListener配合定时任务每天跑一次把结果写进一张notify表不引入额外框架的前提下这是成本最低的方案。安装过数据库、部署过 Tomcat、改过连接串之后你会意识到这套资源最有价值的地方不是「能跑」而是「每一层都能看透」浏览器到 JSP 是一条线Servlet 到 HouseManager 是一条线JDBC 到 MySQL 是一条线三条线串起来就是 Java Web 课设的完整骨骼。从那以后我每次拿到类似的源码包都会强制自己先走一遍「导 SQL → 改连接 → 启动」的流程再谈功能的增删改查希望帮到你。本文还有配套的精品资源点击获取
简介基于Java Web的房屋租赁管理系统完整源码包面向正在学习Java Web开发的学生或需要完成课程设计、毕业设计的开发者。项目基于Eclipse Tomcat MySQL JDK构建包含房源管理、用户注册登录、租赁合同处理等典型业务模块适合用来理解MVC架构、Servlet与JSP交互以及JDBC数据库操作。压缩包共1804个文件约13.32MB主要文件类型包括119个Java源文件、102个JSP页面、146个CSS样式、195张PNG图片、2个SQL数据库脚本以及若干配置文件其中SQL脚本可直接导入MySQL完成数据库初始化源码中的连接配置可按本地环境修改。目前已有1275人学习下载。借助该资源可快速获得一套可运行的房屋租赁系统原型并对照源码与数据库脚本梳理完整开发流程对提升综合排错与部署能力很有帮助。1. 这套房屋租赁管理系统源码 数据库一起给的 Java Web 实战包很多人下到的课程设计资源要么只有源码没有数据库脚本要么SQL文件导进去全是外键报错能跑起来的少。这套基于 Java Web 的房屋租赁管理系统压缩包里同时给了 Eclipse 工程和数据库脚本Tomcat MySQL 就能把整条链路拉起来属于典型的「能跑、能讲、能答辩」资源。它解决的是信息管理类课设最常见的问题房源信息的增删改查、用户注册登录、租赁合同记录以及这些模块之间怎么通过 Servlet JSP JDBC 串起来。适合正在做 Java 课程设计或毕业设计的学生也想搞明白 Servlet 和 JSP 到底怎么交互、数据库连接放在哪一层的人如果你已经在用 Spring Boot这套资源的定位更适合往回补基础。2. 环境铺平JDK、Tomcat、MySQL 版本选型与验证2.1 技术栈为什么是这套组合这套系统走的是典型的 B/S 结构浏览器发 HTTP 请求Tomcat 作为 Servlet 容器负责接请求把请求交给 Servlet 处理业务逻辑最后由 JSP 渲染页面返回。MySQL 在底层存房源、用户、租赁记录Java 程序通过 JDBC 和 MySQL 通信。四个组件各管一段没有 Spring 全家桶那样的大框架包装每一层都能直接看到代码这恰恰是课程设计和毕设最看重的点——导师问「这块怎么实现的」时你能从 Servlet 的 doPost 一路讲到 SQL 语句而不是甩出一句「框架封装好了」。Eclipse 在这里不只是编辑器还承担了项目的构建和部署职责。你在 Eclipse 里导入工程配置好 Tomcat点 Run As 直接在本地把应用跑起来。不需要额外装 Maven项目依赖的 JDBC 驱动 jar 一般放在 WebContent/WEB-INF/lib 下IDE 会直接加载。对新手来说这一步少了很多 Aur 依赖下载的折腾对熟手来说也能一眼看清项目没有隐藏的黑匣子依赖。2.2 版本匹配与安装验证先说版本对应关系。JDK 8、Tomcat 8.5 或 9.0、MySQL 5.7 或 8.0 是这套技术栈最稳妥的组合。JDK 8 是 Java Web 课程设计的万金油编译器级别低、兼容性最好Tomcat 8.5 对 JDK 8 支持完整Servlet 3.1 规范正好匹配MySQL 5.7 和 8.0 都能用但如果你的 MySQL 是 8.0JDBC 驱动 jar 必须换成mysql-connector-java-8.x这是最常见的翻车点后面第 3 章详细说。环境装完后按下面的顺序做验证java -version mysql -uroot -p # Tomcat 启动Windows 用 startup.batLinux/macOS 用 startup.sh bin/startup.sh第一条命令确认 JDK 能编译运行第二条确认数据库能登录后面导入 SQL 脚本要用第三条把 Tomcat 拉起来浏览器访问http://localhost:8080看到 Tomcat 默认页面就说明 Servlet 容器正常。这里补充一个参数如果 8080 端口被占去 Tomcat 的conf/server.xml里找到Connector port8080 ...把端口改成 8081 或 8082改完重启。我在机房电脑上遇到过一次 8080 被 Oracle 的XDB服务占用的情况当时就是改 port 解决的。还有一个值得强调的是 Tomcat 的版本有些同学装了 Tomcat 10结果发现项目里javax.servlet包全部过时因为 Tomcat 10 换成了jakarta.servlet这类报错说明版本不兼容换成 Tomcat 8.5 或 9 最省事。2.3 导入 Eclipse 前要确认的四个配置从压缩包解压出的工程导入方式和新建项目完全不同。正确操作是File - Import - Existing Projects into Workspace然后选中工程根目录勾选Search for nested projects。导入后不要急着运行先确认以下四项第一工作空间的编码。Window - Preferences - Workspace - Text file encoding选 UTF-8。如果编码不统一你看到的中文注释全是乱码更麻烦的是 JSP 页面里的中文在浏览器里显示成问号。第二项目的 Java Compiler 级别。右键项目进Properties - Java Compiler确认Compiler compliance level和本机 JDK 匹配常见组合是 1.8 对应 JDK 8。第三Server Runtime 里要能看到 Tomcat。Window - Preferences - Server - Runtime Environments里 Add 一个 Tomcat 8.5路径指向你解压的 Tomcat 目录Eclipse 才能把项目发布到容器里。第四检查WebContent/WEB-INF/lib下有没有 MySQL 驱动 jar。如果没有去下载mysql-connector-java-5.1.49.jar或 8.0 版本手动拷进去再右键项目Build Path - Add to Build Path。这一步不做后面启动必报ClassNotFoundException: com.mysql.jdbc.Driver。3. 数据库那条线SQL 脚本执行、JDBC 连接与三个隐蔽参数3.1 SQL 脚本里有什么建表顺序与初始数据资源包里的 SQL 文件夹通常是整个系统的地基。脚本一般先建库再建表插入初始数据。我建议用命令行执行比图形化工具更能看清报错位置mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS house_manager DEFAULT CHARSET utf8mb4; mysql -uroot -p house_manager house_manager.sql第一条命令先建库指定utf8mb4字符集避免中文乱码第二条命令把脚本导入到对应库里。注意house_manager.sql脚本里如果已经有CREATE DATABASE语句那么第二条命令可以不带库名执行这时要用mysql -uroot -p house_manager.sql。建表脚本里典型的用户表长这样CREATE TABLE user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, phone VARCHAR(20), role TINYINT DEFAULT 1 COMMENT 1-租客 2-管理员 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有一个很典型的坑user是 MySQL 的保留字不加反引号直接建表会报语法错误。写脚本的人一般会用反引号把它包起来你自己写 SQL 时也要养成这个习惯否则 MySQL 会把user当成mysql.user那个系统表。除了user表资源里通常还有house房源表和rent租赁合同表。导入时如果脚本里有外键约束要注意执行顺序——先建被引用的表再建引用别人的表也就是house和user先建rent后建。如果你的脚本一次导入报外键错误常见解决方法是把脚本里的CREATE TABLE语句手动拆开按依赖关系分批执行。3.2 JDBC 连接配置在项目里的落点这个项目的数据访问层一般有两种写法一种是把连接参数放在src/db.properties文件里再配合DBUtil.java读取另一种是直接在DBUtil.java里硬编码 URL、用户名和密码。前一种改配置方便后一种源码结构相对简单。我拿到这类资源时会优先找db.propertiesjdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/house_manager?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password123456注意驱动类名MySQL 5.x 用com.mysql.jdbc.DriverMySQL 8.0 必须改成com.mysql.cj.jdbc.Driver。连接串里serverTimezoneAsia/Shanghai是关键参数MySQL 8.0 不写这个参数启动时必报时区错误characterEncodingutf8负责中文字符传输useSSLfalse是关闭本地开发时的 SSL 握手不加的话日志里会有 warning虽然不影响运行但答辩时被问到会很尴尬。如果项目里没有db.properties那就是DBUtil.java硬编码找到getConnection()方法直接改字符串。改完以后这里的用户名、密码必须和本机 MySQL 一致。很多同学把资源里默认的root/123456当成账号直接用结果本地 MySQL 的 root 密码根本不是这个数据库连接失败然后满世界找「为什么连不上数据库」。这一步正确的做法是先用命令行mysql -uroot -p验证自己的账号密码能登录再填到配置文件里。3.3 连接串不写参数会怎样我见过的场景是项目部署好了首页能打开但一提交登录表单就白屏控制台报Communications link failure或者The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。前者是驱动版本和 MySQL 版本不匹配后者是连接串缺少 serverTimezone 参数。这两个坑往往同时出现因为 MySQL 8.0 的驱动强制要求指定时区。另一个隐蔽问题是中文乱码。如果页面输入中文后存进数据库变成??排查顺序是先看 JSP 页面有没有% page contentTypetext/html; charsetUTF-8 %再看连接串有没有characterEncodingutf8最后看数据库表本身的字符集是不是utf8mb4。这三个环节有一个不是 UTF-8中文就保不住。写连接串的时候宁可多写两个参数也别让这些问题在答辩前夜冒出来。4. 核心链路拆解登录到房源管理的 Servlet HouseManager 走查4.1 登录请求是怎么被处理的登录是整个系统的入口也是理解 MVC 在项目里真实形态的最佳样本。浏览器把表单 POST 给一个 Servlet 映射的 URLServlet 在doPost里拿参数、调 DAO、查数据库最后决定跳转还是转发。典型的登录 Servlet 长这样WebServlet(/login) public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDAO dao new UserDAO(); User user dao.findByUsernameAndPassword(username, password); if (user ! null) { request.getSession().setAttribute(loginUser, user); response.sendRedirect(request.getContextPath() /house/list); } else { request.setAttribute(msg, 用户名或密码错误); request.getRequestDispatcher(/login.jsp).forward(request, response); } } }这段代码有三个信息值得注意。第一request.setCharacterEncoding(UTF-8)必须放在最前面否则 POST 过来的中文参数会乱码。第二登录成功后用sendRedirect做重定向配合getContextPath()拿到应用上下文路径这样不管项目部署成什么名字都不会拼错路径登录失败用forward转发回登录页同时带上错误提示。第三Session 里存的是User对象后续 JSP 页面靠session.getAttribute(loginUser)判断用户是否登录。项目里如果资源用的不是注解而是web.xml配置 Servlet 映射实现方式也是等价的区别只在servlet-mapping那段 XML 里。4.2 HouseManager 的增删改查与 SQL 参数传递HouseManager是这套系统里的核心业务处理类负责房源信息的增删改查。这个类里通常写着纯粹的 JDBC 操作每层方法干一件事addHouse插一条房源deleteHouse按 id 删updateHouse改价格和状态queryHouse按条件查。查询方法是最能看出功底的因为要处理可选的关键字和价格区间public ListHouse queryHouse(String keyword, double minPrice, double maxPrice) { StringBuilder sql new StringBuilder(SELECT * FROM house WHERE status 1); if (keyword ! null !keyword.trim().isEmpty()) { sql.append( AND address LIKE ?); } if (minPrice 0) { sql.append( AND price ?); } if (maxPrice 0) { sql.append( AND price ?); } // 按需求追加排序条件 sql.append( ORDER BY publish_time DESC); PreparedStatement ps conn.prepareStatement(sql.toString()); // 按条件个数依次 setString / setDouble }这套写法的核心是动态拼 SQL先拼好固定部分再把可选条件逐个追加最后用PreparedStatement的占位符?传参。为什么要用PreparedStatement而不是Statement直接拼字符串因为参数里如果带了单引号或特殊字符直接拼 SQL 轻则报错重则被撞库注入这是新手最容易忽略的点。参数顺序要和 SQL 里?出现的顺序一致先setString设置关键字再setDouble设置价格区间顺序反了会报参数类型错误。4.3 租赁合同记录与事务控制租赁合同表把user和house关联起来一笔租赁记录对应一个租客、一套房源、起止日期和租金。签合同这个动作有一个隐含的业务规则房源状态要从「可租」改成「已租」。如果把这两步拆成两条独立的 insert 和 update中间任何一步失败数据库里就会出现「房源已经租出去但合同没签上」或「合同签了但房源还在租」的脏数据。正确的做法是把两步包进一个事务Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 手动开启事务 // 1. 向 rent 表插入合同记录 // 2. 更新 house 表的 status 字段为已租 conn.commit(); // 都成功才提交 } catch (Exception e) { if (conn ! null) { conn.rollback(); // 任何一步失败全部回滚 } throw e; } finally { DBUtil.close(conn); }setAutoCommit(false)是事务的开关commit()是确认两组写操作都成功rollback()是出了异常把数据库还原到操作前的状态。这套写法在课程设计里看起来不大但面试和答辩时被问「怎么保证数据一致性」的概率极高。你可以顺着这个点再往深说一层如果把系统优化成生产级可以选择把连接管理交给数据库连接池比如 DBCP 或 HikariCP事务的写法不变但连接获取和释放的方式会正规得多。不过对于当前这套资源直连方式反而更容易把逻辑讲清楚。5. 本地部署与常见问题排查404、乱码、数据库拒绝连接5.1 完整部署步骤与日志定位拿到资源后建议按固定顺序跑一遍先导 SQL 脚本再改数据库连接配置最后启动 Tomcat。顺序反过来会报「表不存在」或「连接失败」。部署时在 Eclipse 里选中项目右键Run As - Run on Server选择已经配置好的 TomcatIDE 会自动完成编译、发布和启动。浏览器访问地址是http://localhost:8080/项目名/这里的项目名是部署上下文路径默认取工程文件夹名。如果首页在根路径下直接访问http://localhost:8080/工程名/即可不用额外加index.jsp。运行期间出问题第一件事不是看浏览器而是看控制台日志。Eclipse 的 Console 窗口会输出 Tomcat 的启动日志如果是手动启动的 Tomcat日志在logs/catalina.out或logs/localhost.日期.log。日志里搜Exception或Caused by定位真正的原因一般不需要超过两行。5.2 现象页面 404项目启动但访问不到这个是最常见的问题。分两种情况一种情况是http://localhost:8080/能打开 Tomcat 默认页面但加项目名后 404说明应用上下文路径不对检查部署的名称和你输入的路径是否一致去 Eclipse 的 Servers 视图双击 Tomcat看Modules标签页里的 Path 是什么。另一种情况是整个项目编译失败状态显示不是 Started通常是因为代码有编译错误或缺少 jar 包CtrlShiftT 搜DBUtil或LoginServlet看类是否存在。5.3 现象控制台中文乱码页面显示问号乱码要从两层看。第一层是 Java 源文件和 JSP 文件的编码检查工作空间编码是否为 UTF-8JSP 头部有没有声明pageEncoding。第二层是运行时的字符集传递POST 请求靠request.setCharacterEncoding(UTF-8)数据库连接靠连接串里的characterEncodingutf8。我的习惯是先把数据从 MySQL 里查出来直接在代码里输出到控制台看 Console 里是不是乱码如果代码里是正常的但页面乱问题出在 JSP 响应编码如果代码里已经乱了问题在数据库连接或表字符集。按这个顺序排查不用瞎猜。5.4 现象Access denied 或 Communications link failure数据库连接失败时日志里最常见的是这两个。Access denied for user rootlocalhost说明账号或密码不对去db.properties检查用户名密码是否和本地 MySQL 一致Communications link failure通常有三种原因MySQL 服务没启动、端口不是 3306、驱动配错。先用命令行mysql -uroot -p试一次确认 MySQL 能登录再SHOW VARIABLES LIKE port;看端口号是不是 3306最后看配置 URL 里写的端口是否一致。如果用的是 MySQL 8.0还要确认驱动 jar 版本和驱动类名都是 8.0 对应的写法。这类排查有个通用的规律——出了问题永远从「日志的第一条 Caused by」开始看不要看最顶上的大段堆栈。堆栈最顶部的异常往往只是表象真正的原因被包在Caused by之后的几行里。把那几行读明白百分之八十的部署问题都能自己解决。6. 进阶给合同表加一个到期提醒接口系统跑通之后可以做一个小而完整的扩展给自己加深印象。租房业务有一个很实际的需求合同快到期了要提前提醒管理员和租客。改造的思路很简单在rent表已有的end_date字段上做一次日期查询把 30 天内到期的合同拉出来。新建一个 Servlet专门处理到期合同查询WebServlet(/contract/expire) public class ContractExpireServlet extends HttpServlet { protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String sql SELECT c.id, h.address, u.username, c.end_date FROM rent c JOIN house h ON c.house_id h.id JOIN user u ON c.user_id u.id WHERE DATEDIFF(c.end_date, CURDATE()) BETWEEN 0 AND 30 ORDER BY c.end_date; // 执行查询把结果放到 request 里转发到 expire_list.jsp } }这段 SQL 里的DATEDIFF(c.end_date, CURDATE())计算合同结束日期和今天之间相差的天数BETWEEN 0 AND 30取 0 到 30 天内的记录也就是说只报已经到期和未来 30 天内到期的合同。JOIN关联出房源地址和租客姓名视图层显示时直接读这几个字段不用再查第二遍数据库。如果想让提醒更自动化可以在项目启动时用ServletContextListener配合定时任务每天跑一次把结果写进一张notify表不引入额外框架的前提下这是成本最低的方案。安装过数据库、部署过 Tomcat、改过连接串之后你会意识到这套资源最有价值的地方不是「能跑」而是「每一层都能看透」浏览器到 JSP 是一条线Servlet 到 HouseManager 是一条线JDBC 到 MySQL 是一条线三条线串起来就是 Java Web 课设的完整骨骼。从那以后我每次拿到类似的源码包都会强制自己先走一遍「导 SQL → 改连接 → 启动」的流程再谈功能的增删改查希望帮到你。本文还有配套的精品资源点击获取
