简介一套基于IDEA开发的Java图书管理系统完整项目资源主要面向Java初学者、课程设计学生以及需要快速搭建后台管理系统的开发者。资源包共包含68个文件以Java源码和编译后的class文件为核心搭配JSP、HTML、CSS、JS前端页面PNG界面截图XML配置信息以及设计模式类图文档docx压缩包整体约7.09MB目录结构清晰便于按模块检索与对照学习。系统覆盖用户注册登录、图书增删改查、借阅归还等常见业务模块采用MVC分层思想组织代码将Servlet、JSP、数据库操作与前端交互完整串联起来。对于正在做课程设计或想提升JavaWeb实战能力的读者可直接参考项目结构、数据库表设计思路以及前后端调用方式节省从零搭建的时间。目前已有1642人学习下载适合作为校园项目或入门练手的实用素材。1. 基于IDEA的图书管理系统为什么值得照着做一遍刚学完Java基础最容易卡住的一步不是语法而是“一个项目从零到能在浏览器里点开”。图书管理系统恰恰是卡点上最顺手的练手题它不涉及分布式、不涉及高并发却完整覆盖了JavaWeb开发的常规链路——建表、连库、页面交互、业务状态流转借出/归还/库存变更。用IDEA作为开发环境从建工程到部署Tomcat到跑通登录和借还是你把“会敲代码”变成“能做系统”的第一块跳板。这篇文章按我自己的开发习惯展开先讲技术选型和环境配置再给建表脚本和核心代码最后把我在IDEA里跑这类项目遇过的五个高频问题列出来。照着走你会在半天内拿到一个能交给面试官演示、也能作为课程设计交差的图书管理系统。2. 技术选型与IDEA环境准备SSM组合为什么适合图书管理系统2.1 组合选型图书管理系统用哪套技术栈最稳图书管理系统的本质是“对一张图书表做增删改查 对借阅记录做状态管理”。这类业务用SSMSpring SpringMVC MyBatis是Java岗位面试里最常见的组合比Servlet JSP多了一点分层和依赖注入的练习价值又比Spring Boot少了一些你还没搞懂的“自动配置魔法”。我建议首次做这个项目就走SSM因为等你面到Java后端岗位问得最多的Mapper接口和声明式事务都在这个组合里。前端不用Vue用JSP加Bootstrap就够了。原因很实在这个项目的重点在Java侧的数据流转不要在前后端分离上花额外时间另外JDK内置Servlet容器处理JSP最顺遇到问题网上资料也最多。数据库用MySQL 5.7或8.0均可我自己的经验是如果你电脑上已经装了MySQL 8.0就用8.0连接驱动注意选com.mysql.cj.jdbc.Driver别用老版的com.mysql.jdbc.Driver。IDEA版本上有两个选择社区版免费但缺少对JavaWeb的完整支持配置Tomcat要靠手动插件旗舰版开箱即用。如果你用的是社区版别急着找破解方案直接用Maven的tomcat7-maven-plugin插件启动项目是更省事的路子我后面会给配置。2.2 IDEA配置的四个关键点Maven、Tomcat、编码、JDK版本这四个点不先配好后面每一步都会返工。第一次建项目时我建议你按这个顺序检查一遍。第一Maven的settings.xml路径和仓库位置。打开IDEA的Settings → Maven确认User settings file指向你本机的settings.xmlLocal repository指向本地仓库。默认的C盘路径容易占满系统盘我一般改到D:/maven/repo在settings.xml里改localRepository节点即可。如果下载依赖非常慢检查镜像配置国内一般用阿里云镜像。mirror idalimaven/id mirrorOfcentral/mirrorOf namealiyun maven/name urlhttps://maven.aliyun.com/repository/central/url /mirror这段配在settings.xml的mirrors节点里。作用是让Maven从阿里云镜像拉依赖避免卡在Maven中央仓库上。注意mirrorOf写central只代理中央仓库不会影响你自己公司私服的包。第二Tomcat的配置方式。旗舰版直接在Run Configuration里加Tomcat Server社区版没有这个选项我常用的是在pom.xml里引入tomcat7插件用mvn tomcat7:run启动插件配置如下plugin groupIdorg.apache.tomcat.maven/groupId artifactIdtomcat7-maven-plugin/artifactId version2.2/version configuration port8080/port path//path uriEncodingUTF-8/uriEncoding /configuration /pluginport是启动端口path是上下文路径写/表示访问根路径直接进入项目首页。uriEncoding必须写UTF-8否则你从前端传中文到后端时会有一堆乱码问题。第三全局编码统一成UTF-8。位置在Settings → Editor → File Encodings把Global Encoding、Project Encoding、Properties Files的编码全部改成UTF-8。再配合Tomcat的uriEncoding基本能杜绝“页面正常、数据库乱码”这种玄学。第四JDK版本对应。用JDK 8跑SSM是最稳的Spring 5.x和JDK 8是长期验证过的组合。如果你已经装了JDK 17会遇到illegal-access警告和一些反射权限问题不是不能跑但排查成本对新手不友好。我建议这个项目老老实实用JDK 8在Project Structure里把Project SDK和项目语言级别都指到1.8。2.3 新建SSM项目的骨架结构在IDEA里新建Maven项目时选maven-archetype-webapp或者建好普通Maven项目后手动补上webapp目录我习惯直接建webapp骨架。项目结构如下book-manage/ ├── pom.xml ├── src/main/java │ ├── com/example/book/controller/ │ ├── com/example/book/service/ │ ├── com/example/book/mapper/ │ ├── com/example/book/entity/ │ └── com/example/book/config/ ├── src/main/resources │ ├── spring-mvc.xml │ ├── spring-mybatis.xml │ ├── jdbc.properties │ └── mybatis-config.xml └── src/main/webapp ├── WEB-INF/web.xml ├── views/ │ ├── login.jsp │ ├── bookList.jsp │ └── borrowRecord.jsp └── static/这个结构的价值在于分层清晰controller负责接收请求service负责业务规则mapper负责SQLentity放实体类。等做到“给图书管理系统加一个报表功能”的进阶需求时你只需要动service和新增一个mapper方法就能完成不用把SQL散落在JSP里。pom.xml里最关键的是这几组依赖Spring核心spring-context、spring-webmvc、spring-jdbc、spring-tx、MyBatismybatis、mybatis-spring、数据库驱动mysql-connector-java、Servlet与JSPservlet-api、jsp-api、Jackson用于返回JSON。具体版本建议以2.5.6Spring和1.3.2mybatis-spring为基准这几个版本组合比较成熟。properties spring.version5.2.5.RELEASE/spring.version mybatis.version3.5.4/mybatis.version /properties版本统一放在properties节点有两个原因一是后续升级只需要改一处二是Spring和MyBatis之间通过mybatis-spring适配Spring版本异常时你能快速定位是版本兼容问题还是配置问题。3. 业务建模与数据库脚本从三张表设计出借阅闭环3.1 实体关系图书管理系统最少需要三张表图书管理系统的核心业务流是“管理员维护图书读者借书、还书”。围绕这个流程最小可行的数据模型是三张表user用户/管理员、book图书、borrow_record借阅记录。很多初学项目只做两张表——用户和图书把借还直接改成修改图书表的“借阅状态”字段。这种做法做演示可以但一旦要问“这本书被谁借走了”“超期几天没还”就答不上来。借阅记录独立成表才能回答这类真实问题。这三张表的关系是user和book是多对多borrow_record作为中间表承载每次借借还还。borrow_record里冗余了书的部分信息和借阅人的ID这样查询借阅列表时不需要每次联表这也是小项目常见的取舍。3.2 建表脚本字段设计直接决定后续写SQL的舒服程度CREATE DATABASE IF NOT EXISTS book_manage DEFAULT CHARSET utf8mb4; USE book_manage; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, real_name VARCHAR(50), role TINYINT DEFAULT 0 COMMENT 0-普通用户 1-管理员, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, isbn VARCHAR(20) NOT NULL, book_name VARCHAR(100) NOT NULL, author VARCHAR(50), publisher VARCHAR(100), category VARCHAR(50), total_count INT DEFAULT 0, remaining_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_isbn (isbn), INDEX idx_category (category) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, book_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, return_time DATETIME, status TINYINT DEFAULT 0 COMMENT 0-借出中 1-已归还, CONSTRAINT fk_borrow_user FOREIGN KEY (user_id) REFERENCES user(id), CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;建表时的几个细节字符集要写在CREATE DATABASE和CREATE TABLE两层只写数据库层不写表层建表时会继承数据库默认字符集容易出乱码。password字段长度给100而不是50因为后面如果用MD5或BCrypt加密密文长度不止50位。remaining_count单独存一个字段不要每次用total_count减去在借数量去实时计算。小项目里实时计算没问题但表数据到几万条后每次列表页都聚合计算数据库会开始吃力。冗余这个字段代价是每次借书/还书都需要同时更新它这是个典型的“你用空间换查询速度”的决定。借阅记录和user_id、book_id都建立外键关系。外键在这个项目里值得建因为数据量小外键能帮你挡住脏数据——比如借阅记录里指向一个不存在的图书ID。3.3 初始化数据准备几本你能记住的测试图书INSERT INTO user (username, password, real_name, role) VALUES (admin, e10adc3949ba59abbe56e057f20f883e, 系统管理员, 1); INSERT INTO book (isbn, book_name, author, publisher, category, total_count, remaining_count) VALUES (9787115428028, Java核心技术 卷I, 凯·S.霍斯特曼, 机械工业出版社, 编程, 5, 5), (9787111213826, 深入理解Java虚拟机, 周志明, 机械工业出版社, 编程, 3, 3), (9787115275790, 算法导论, CLRS, 机械工业出版社, 算法, 2, 2);这里admin的密码是123456的MD5值。我的建议是教学项目用MD5可以接受但你在真实项目里务必用BCrypt。这段初始化数据不需要多三四本足够测试用重点是你自己记住这些书的ID和名称后面写借书功能时可以直接拿来测试。4. 核心功能实现从登录拦截到借书还书的完整链路4.1 Spring与MyBatis配置让Mapper接口能被扫描到这个项目里最容易被忽视的配置是把Mapper接口扫描和SqlSessionFactory正确接起来。我在spring-mybatis.xml里通常这样写!-- 数据库连接池 -- bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean !-- SqlSessionFactory -- bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nametypeAliasesPackage valuecom.example.book.entity/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean !-- 扫描Mapper接口 -- bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.book.mapper/ /bean逻辑说明dataSource用的是Druid连接池日常练习如果不想引入额外依赖改成Spring自带的DriverManagerDataSource也能跑。mapperLocations指向classpath:mapper/*.xml意思是MyBatis的SQL语句写在XML文件里不写进注解。我推荐SQL写XML而不是注解因为这个项目之后如果要加多表联查或动态SQLXML的可读性和维护性明显更好。typeAliasesPackage的作用是让resultType写实体类短类名而不需要写全限定名。比如resultTypeBook而不是com.example.book.entity.Book。少写几个字母不是关键关键是SQL文件换包名时不用大改。4.2 登录认证拦截器统一判断Session不写重复代码登录逻辑不复杂Controller接收用户名密码调Service查库比对MD5值写Session。但很多新手把这个验证逻辑散落在每一个页面Controller里每个方法都先判断Session里有没有user代码冗余且容易漏。我的做法是写一个拦截器public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { // 未登录直接重定向到登录页 response.sendRedirect(request.getContextPath() /login); return false; } return true; } }这段代码的逻辑很直接preHandle方法在每个请求进入Controller之前执行从Session里取loginUser取不到说明没登录就重定向到登录页并返回false阻止请求继续。这样你在后续写图书列表、借书、还书这些页面时不再需要在每个方法里重复判断登录态。在spring-mvc.xml里注册拦截规则mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/static/**/ bean classcom.example.book.config.LoginInterceptor/ /mvc:interceptor /mvc:interceptorsmapping配置拦截所有请求exclude-mapping放行登录页和静态资源。注意顺序不能反过来——如果先写了/static/**的拦截再写/**Spring会按照配置顺序匹配可能导致静态资源也被拦截。4.3 图书查询与分页用PageHelper还是手写LIMIT图书列表页的查询是这本书系统里最常用到“搜索”的场景按书名模糊查询、按分类筛选、分页显示。对于这种规模不需要上分页插件手写一个PageResult类更直观。Mapper的XML里我这样写select idselectBookPage resultTypeBook SELECT id, isbn, book_name, author, publisher, category, total_count, remaining_count FROM book where if testbookName ! null and bookName ! AND book_name LIKE CONCAT(%, #{bookName}, %) /if if testcategory ! null and category ! AND category #{category} /if /where ORDER BY id DESC LIMIT #{offset}, #{pageSize} /select这个XML里的where标签是MyBatis动态SQL的核心用法当bookName有值时自动拼上模糊查询条件没有值时自动忽略。LIMIT #{offset}, #{pageSize}是分页的参数其中offset是起始行数等于(pageNum - 1) * pageSizepageSize是每页条数。两个参数都放在Service层计算好再传进来不在XML里写表达式避免SQL注入和参数歧义。对应Service层的关键代码public PageResultBook queryBookPage(String bookName, String category, int pageNum, int pageSize) { int offset (pageNum - 1) * pageSize; ListBook list bookMapper.selectBookPage(bookName, category, offset, pageSize); int total bookMapper.countBook(bookName, category); return new PageResult(list, total, pageNum, pageSize); }这里有两个地方容易出错。第一个是offset的公式很多新手直接传pageNum给SQL导致第二页查询结果和第一页重复第二个是总值total必须单独用COUNT(*)查询不能在SQL里用SELECT COUNT(*) OVER()配合LIMITMySQL 5.7不支持窗口函数这样写会导致部署到5.7的服务器上直接报SQL语法错误。4.4 借书与还书一个数据事务的典型案例借书和还书的核心是“改两条数据”借书要更新borrow_record表插入一条记录再更新book表把remaining_count减1还书要更新borrow_record表的状态和归还时间再把remaining_count加1。这两步必须在一个事务里完成否则会出现“借阅记录有了但库存没减”的数据不一致问题。Service层代码Override Transactional(rollbackFor Exception.class) public boolean borrowBook(int userId, int bookId) { Book book bookMapper.selectById(bookId); if (book null || book.getRemainingCount() 0) { return false; } // 插入借阅记录 BorrowRecord record new BorrowRecord(); record.setUserId(userId); record.setBookId(bookId); record.setStatus(0); borrowRecordMapper.insert(record); // 库存减一 int rows bookMapper.decreaseRemaining(bookId); return rows 0; }Transactional(rollbackFor Exception.class)是这段代码的关键。其中rollbackFor指定任何异常都触发回滚这很重要——Spring默认只在RuntimeException时回滚如果你在业务方法里抛出的是自定义的BookException extends Exception没有这个参数事务不会回滚库存数据会悄悄出问题。bookMapper.decreaseRemaining(bookId)对应的SQL是UPDATE book SET remaining_count remaining_count - 1 WHERE id #{id} AND remaining_count 0把remaining_count 0写在WHERE条件里是一个经典的做法。它用数据库层面的条件判断避免了并发场景下的超借问题——两个请求同时读到remaining_count 1时只有第一个能更新成功第二个的rows会为0然后事务回滚。如果这个判断放在Java代码里做并发时就会出bug。还书流程是对称的更新借阅记录状态为1、更新归还时间再执行UPDATE book SET remaining_count remaining_count 1 WHERE id #{id}。这里不需要加条件了还书不会产生负数问题。5. 避坑指南IDEA运行图书管理系统最常见的五个问题5.1 运行后访问页面是404IDEA不生成target目录现象项目启动后Tomcat正常起来但浏览器访问项目地址直接404IDEA的target目录一直不出现或内容不完整。原因最常见的是IDEA没有把项目交给Maven管理或者Maven的package阶段没跑成功。另一个情况是社区版手动配了Tomcat后部署的内容来源是IDEA的编译输出目录而不是Maven的target目录。解决在IDEA右侧Maven面板里先执行clean再执行package确认IDEA已经识别了所有Maven依赖。如果是社区版手动加的Tomcat检查Run Configuration里Deployment标签页中Deploy at server startup的Artifact是否选择了你项目的war exploded。我自己的习惯是直接用mvn tomcat7:run这样就完全绕开了部署目录的问题。5.2 中文乱码页面是好的数据库存进去成了问号现象登录页显示正常但新增图书名保存到MySQL后变成???或者从数据库查到页面变成乱码。原因这是典型的字符集链断裂JavaWeb请求从浏览器到后端要经过Tomcat解码、SpringMVC参数编码、JDBC连接编码三层。只要一层不是UTF-8中文就废掉。解决按三个地方排查。第一Tomcat的server.xml里Connector节点的URIEncodingUTF-8第二jdbc.properties的连接URL上加上characterEncodingutf8第三MySQL表本身就是utf8mb4的建表脚本里已经写了。多加一句MySQL连接的URL末尾要带serverTimezoneAsia/ShanghaiMySQL 8.0不指定时区连接会直接报错。5.3 Mapper接口注入为Null / 找不到该类型的Bean现象启动项目时Spring容器报NoSuchBeanDefinitionException找不到bookMapper这个Bean或者请求到Controller时报NullPointerException一看是Mapper为null。原因MapperScannerConfigurer的basePackage扫描包路径不对或者Service注解没加在Service实现类上。新手很容易在Controller里直接Autowired一个Mapper接口而不是注入Service但Mapper接口的Bean如果没有被扫描到注入必然失败。解决回到spring-mybatis.xml确认basePackage写的是Mapper接口所在的包全路径。同时在Service实现类上确认有Service注解Controller只AutowiredService不要直接注入Mapper。这个设计也是在逼你保持分层思想。5.4 borrow_record插入时外键约束失败现象点击借书按钮后页面报Cannot add or update a child row: a foreign key constraint fails或用POSTMAN调接口直接返回500。原因前端传过来的bookId在book表里不存在或者SQL里传的ID是字符串而表和Java中都是intMySQL做隐式转换导致实际ID对不上记录。解决在Service方法里先通过selectById校验书存在且库存充足——上面的借书代码里其实已经做了这个校验。剩下要检查的是前端表单字段名和方法参数名的映射关系比如JSP里input的name是bookIdController方法参数得是RequestParam(bookId) Integer bookId少一个注解就会拿到null。5.5 IDEA一直提醒JDK版本过高Spring初始化失败现象使用JDK 11以上版本运行时控制台出现Illegal reflective access警告随后部分Bean初始化失败尤其CGLIB代理相关的类报错。原因Spring 5.2在高版本JDK下反射访问模块受限CGLIB创建代理时需要反射调用受保护的类JDK模块系统默认不允许。解决我建议直接换JDK 8这是性价比最高的方案。如果你舍不得换试一下在IDEA的VM options里加--add-opens java.base/java.langALL-UNNAMED这个参数能解开大部分反射限制。但话说回来新手阶段不值得在版本兼容性上耗时间图书管理系统用JDK 8跑是最简洁的路线。6. 再往前走一步把图书管理系统升到能拿得出手的程度如果你已经照着上面的步骤跑通了登录、分页、借还书这几个核心功能下一步建议做一个“借阅记录导出”功能。这个需求几乎每个图书管理系统都会被问到——学校图书馆需要按月统计借阅量。你不用上POI这类重量级库先做一个CSV导出接口逻辑简单且能快速验证你的代码是否健壮。在BorrowRecordMapper里新增两个方法一个selectRecordsByTimeRange一个countByCategory分别用于导出记录和统计报表。Controller里接收startDate和endDate参数Service层把查询结果拼成CSV格式的字符串设置响应头Content-Disposition: attachment就能触发浏览器下载。这个功能的完整度足够在答辩或面试里演示三层架构的分工了。做完这个功能去Postman里把每个接口的边界情况都过一遍不存在的图书ID借书、重复借同一本书、库存为0时借书、跨天借还的日期条件查询。我当年以为自己写完功能就万事大吉结果在面试官面前当场暴露出“库存扣成负数”的翻车现场。现在我会在每个Service方法前先写几行注释标明“输入什么、输出什么、在什么条件下会失败”这比写几十行文档有用得多。这个项目值得投入的时间大概是一周。环境配置一天业务代码三天修bug两天。修bug的这两天才是这个系统最有价值的部分——你会发现大部分问题出在字符集、依赖版本、参数绑定这些不起眼的地方。把这些坑踩过一遍之后再碰Spring Boot、MyBatis-Plus这些现代化工具时你会知道自己手里捏的是什么。希望这篇笔记能帮你少走几步弯路也愿你能从这个系统的“土气”里收获一套扎实的JavaWeb基本功。本文还有配套的精品资源点击获取