拓冰网站定制 
简介这是一份面向Java Web初学者与课程设计者的完整博客系统实战源码适用于毕业设计、大作业及Web开发技能进阶学习。资源包含629个文件总大小18.43MB涵盖55个Java核心业务类、20个JSP动态页面、44个HTML前端结构页、35个JavaScript交互脚本、32个XML配置文件含web.xml与Spring相关配置、以及大量图片jpg/png/gif和样式资源CSS完整呈现MVC分层架构Controller层由Servlet与Action类驱动Service层封装业务逻辑DAO层实现数据库操作JSPELJSTL构成表现层配合MySQL常见表结构设计。已有676人学习下载可直接部署运行快速掌握用户管理、文章发布、评论互动、图片上传等典型功能模块并通过源码深入理解Java Web技术栈的协同机制与工程组织方式。1. 为什么一个“基于Java Web的博客系统源码.zip”值得你花3小时拆解它这不是又一个“Spring Boot Thymeleaf MySQL”的教学Demo。当你双击解压这个zip包看到src/main/java/com/example/blog/下整齐的controller/、service/、mapper/三层结构再翻到pom.xml里明确写着spring-boot-starter-web:2.7.18、mybatis-spring-boot-starter:2.2.5、thymeleaf:3.0.15.RELEASE——你就踩进了真实企业级Java Web项目的最小可行切片它没用Spring Security做RBAC但实现了带密码加密会话校验的登录没上Redis缓存文章列表但用Transactional锁住了评论并发插入连富文本编辑器都只集成了一版轻量级的simditor而非全功能CKEditor。它解决的是「小团队快速上线可维护博客」这个具体问题不是教你怎么写Hello World。适合刚做完SSM课程设计、正卡在「怎么把DAO层和Controller串成闭环」的Java后端新人也适合想给内部知识库搭个轻量后台、拒绝WordPress臃肿的运维同学。别急着跑起来——先看清它怎么用HttpServletRequest原生解析表单、怎么用PageHelper做分页而不暴露SQL、怎么把BlogEntity和BlogVO手动映射而不是靠MapStruct自动生成。这才是.zip里真正值钱的部分。2. 从解压到启动三步跑通这个Java Web博客系统的最小闭环2.1 解压后第一眼必须确认的4个关键文件打开zip包不要直接IDEA导入。先用文本编辑器看这四个文件pom.xml确认Spring Boot版本本项目为2.7.18不支持JDK17需用JDK8或JDK11检查mysql-connector-java是否为8.0.28注意驱动类名已从com.mysql.jdbc.Driver改为com.mysql.cj.jdbc.Driver确认thymeleaf-layout-dialect存在这是页面布局复用的关键。application.yml重点看spring.datasource.url是否含useSSLfalseserverTimezoneAsia/ShanghaiMySQL 8必加否则时区错乱导致发布时间全为0000-00-00mybatis.mapper-locations路径是否为classpath:mapper/*.xml本项目XML映射文件放在resources/mapper/下。schema.sql通常在src/main/resources/执行前先看建表语句——blog表有status tinyint(1) default 1字段但代码里没用枚举类约束而是硬编码1发布,0草稿后续扩展易出错。static/js/main.js搜索$.ajax调用确认所有POST请求头含X-Requested-With: XMLHttpRequest这是Spring Boot默认CSRF拦截器的放行条件漏了会导致403。提示如果pom.xml里出现scopeprovided/scope的javax.servlet-api依赖说明项目兼容Tomcat 9但本地用IDEA内置Tomcat 10会报jakarta.servlet包冲突——此时要么改用Tomcat 9要么把provided改成compile并排除传递依赖。2.2 本地数据库初始化绕过Hibernate自动建表的实操本项目禁用了JPA自动建表spring.jpa.hibernate.ddl-auto: none必须手动执行SQL。别直接复制schema.sql进MySQL客户端——里面混着INSERT INTO user (username, password)的测试数据而密码是明文123456。安全起见分三步操作-- 步骤1创建数据库字符集必须为utf8mb4 CREATE DATABASE blog_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 步骤2执行建表语句删掉所有INSERT语句只留CREATE TABLE -- 注意blog表的content字段类型是LONGTEXT不是TEXT避免超长文章截断 -- 步骤3手动插入管理员用户密码用BCrypt加密 INSERT INTO user (username, password, email, create_time) VALUES (admin, $2a$10$N9qo8uLOickgx2ZMRZoMy.eI0TtVvjozQYiOk2r4Wf0Yx9VzG5D1m, adminexample.com, NOW());密码加密逻辑在UserService.java的register()方法里BCryptPasswordEncoder().encode(rawPassword)。你可用以下Java片段生成新密码// 临时测试类运行后复制输出的BCrypt密文 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; public class PasswordEncoderTest { public static void main(String[] args) { String raw your_new_password; String encoded new BCryptPasswordEncoder().encode(raw); System.out.println(encoded); // 输出类似 $2a$10$... } }2.3 IDEA中启动项目的三个关键配置JDK版本锁定File → Project Structure → Project → SDK选JDK 11若用JDK 8需在pom.xml中将maven-compiler-plugin的source和target设为1.8Active Profiles设置Run → Edit Configurations → Environment variables里添加SPRING_PROFILES_ACTIVEdev项目application-dev.yml含本地数据库配置VM Options避坑添加-Dfile.encodingUTF-8 -Duser.timezoneGMT8否则Linux服务器部署时日志时间错乱。启动成功后访问http://localhost:8080首页应显示3篇测试文章访问http://localhost:8080/admin/login用admin/123456登录后台——注意密码是明文123456但数据库存的是BCrypt密文所以能登录成功。3. 登录功能深度拆解从表单提交到Session校验的完整链路3.1 前端登录表单的隐藏细节templates/login.html里的form标签看似普通form th:action{/admin/login} methodpost input typetext nameusername required/ input typepassword namepassword required/ button typesubmit登录/button /form但关键在th:action{/admin/login}生成的URL是/admin/login而LoginController.java中处理方法是PostMapping(/admin/login) public String login(RequestParam String username, RequestParam String password, HttpServletRequest request, Model model) { User user userService.login(username, password); // 1. 查询用户 if (user ! null) { request.getSession().setAttribute(user, user); // 2. 写入Session return redirect:/admin/index; // 3. 重定向 } else { model.addAttribute(error, 用户名或密码错误); return login; } }注意这里没用Spring Security的AuthenticationManager而是手写userService.login()——该方法先查数据库再用BCryptPasswordEncoder.matches()比对密码。好处是逻辑透明坏处是没集成Remember-Me或OAuth2扩展点。3.2 Session校验的两种实现方式对比项目在后台页面如/admin/write用两种方式校验登录态拦截器方式推荐AdminInterceptor.java实现HandlerInterceptor在preHandle()中检查request.getSession().getAttribute(user)是否为空。若为空response.sendRedirect(/admin/login)。Controller注解方式本项目实际用法每个后台接口方法开头加Object user request.getSession().getAttribute(user); if (user null) { return redirect:/admin/login; }为什么不用拦截器因为项目只有5个后台URL/admin/*硬编码成本更低。但如果你要加/api/*REST接口必须补拦截器——否则AJAX请求返回302重定向前端JS收不到JSON错误。3.3 密码加密与传输安全的实操补丁当前登录存在两个风险前端明文传输表单提交时密码未加密抓包可见明文无验证码防爆破连续输错10次不会锁定账号。补丁方案两行代码搞定在login.html底部加MD5加密仅防抓包非替代HTTPSscript srchttps://cdn.bootcdn.net/ajax/libs/blueimp-md5/2.19.0/js/md5.min.js/script script document.querySelector(form).onsubmit function() { const pwd document.querySelector([namepassword]); pwd.value md5(pwd.value); // 提交前哈希化 }; /script在UserService.login()方法里把数据库查出的密码密文传给matches()前先记录失败次数// 伪代码实际需加Redis或数据库计数 if (failedCount 5) { throw new RuntimeException(账号已被锁定请1小时后重试); }4. 文章管理模块的CRUD陷阱与性能优化点4.1 分页查询的PageHelper踩坑实录BlogController.list()方法用PageHelper实现分页GetMapping(/admin/blogs) public String list(Model model, RequestParam(defaultValue 1) int pageNum) { PageHelper.startPage(pageNum, 10); // 1. 开启分页 ListBlog blogs blogService.list(); // 2. 执行查询 PageInfoBlog pageInfo new PageInfo(blogs); // 3. 封装分页信息 model.addAttribute(pageInfo, pageInfo); return admin/blog_list; }表面没问题但PageHelper的startPage()必须紧挨着查询语句。如果service层有其他数据库操作如先查分类再查文章PageHelper会把前一个查询也分页正确写法是// ✅ 正确PageHelper.startPage()后立即跟Mapper查询 PageHelper.startPage(pageNum, 10); ListBlog blogs blogMapper.selectWithCategory(); // 直接调Mapper // ❌ 错误中间插了其他逻辑 PageHelper.startPage(pageNum, 10); categoryService.getAll(); // 这里触发了另一次查询 ListBlog blogs blogMapper.selectWithCategory(); // 分页失效4.2 富文本内容存储的边界处理simditor编辑器提交的内容含HTML标签如phello/p但BlogEntity.content字段在数据库是LONGTEXT。问题在于若用户粘贴含script的恶意代码后端没过滤就存库XSS风险若文章含大量图片img srcdata:image/png;base64,...会导致content字段超2GBMySQL单字段上限。解决方案入库前过滤在BlogService.save()中用Jsoup清洗String cleanContent Jsoup.clean(rawContent, Whitelist.relaxed() .addTags(img).addAttributes(img, src, alt, width, height));图片外链化修改simditor配置禁用base64上传强制走服务器上传接口simditor: { upload: { url: /admin/upload/image, params: null, fileKey: file, connectionCount: 3, leaveConfirm: 正在上传文件... } }后端UploadController.uploadImage()接收MultipartFile保存到static/upload/目录返回/upload/20240501/abc.jpg路径——这样content字段只存相对路径体积可控。4.3 评论并发插入的Transactional失效场景CommentController.add()方法标注了TransactionalTransactional PostMapping(/comment/add) public String addComment(RequestBody Comment comment, HttpServletRequest request) { User user (User) request.getSession().getAttribute(user); comment.setUserId(user.getId()); comment.setCreateTime(new Date()); commentMapper.insert(comment); // 插入评论 blogService.updateCommentCount(comment.getBlogId()); // 更新文章评论数 return success; }但如果updateCommentCount()抛异常评论仍会插入因为commentMapper.insert()和blogService.updateCommentCount()是两个独立事务后者没加Transactional或传播行为。修复方式// 在BlogService中加事务方法 Transactional public void updateCommentCountAndInsert(Comment comment) { commentMapper.insert(comment); updateCommentCount(comment.getBlogId()); // 此方法内不加Transactional }然后Controller调用blogService.updateCommentCountAndInsert(comment)——确保原子性。5. 部署到Linux服务器的5个血泪经验避坑指南5.1 现象启动后首页CSS/JS 404但控制台无报错原因Spring Boot静态资源路径默认为/static/**但Nginx反向代理时未配置location /static/指向jar包同级目录。解决在Nginx配置中加location /static/ { alias /var/www/blog/static/; # 指向jar包所在目录的static文件夹 expires 1h; }注意alias末尾必须有/且/var/www/blog/static/需提前创建并放好css/、js/文件夹。5.2 现象登录成功后跳转/admin/index却显示404原因Thymeleaf模板路径配置错误。application.yml中spring.thymeleaf.prefix: classpath:/templates/但admin/index.html实际在templates/admin/下而Controller返回admin/index时Thymeleaf会拼成classpath:/templates/admin/index.html——路径正确。真正问题是Linux文件系统大小写敏感Windows开发时文件名是Index.html但Linux服务器上是index.html导致找不到。解决统一用小写命名所有HTML文件并在IDEA中开启Settings → Editor → General → Sensitive case警告。5.3 现象MySQL连接池报Communications link failure原因阿里云RDS默认关闭wait_timeout8小时而HikariCP连接池的connection-test-query未配置空闲连接被RDS主动断开。解决在application-dev.yml中加spring: datasource: hikari: connection-test-query: SELECT 1 validation-timeout: 3000 idle-timeout: 600000 # 10分钟 max-lifetime: 1800000 # 30分钟小于RDS wait_timeout5.4 现象上传图片后访问/upload/xxx.jpg返回404原因Spring Boot默认不提供/upload/**静态资源映射。解决在WebMvcConfigurer实现类中加Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:/var/www/blog/upload/); // Linux绝对路径 }注意file:前缀不能省略且路径必须是绝对路径/var/www/blog/upload/相对路径upload/在Linux下会指向jar包所在目录而非你期望的位置。5.5 现象定时任务Scheduled不执行原因EnableScheduling注解漏加在主启动类上。解决检查BlogApplication.java是否有SpringBootApplication EnableScheduling // 必须有 public class BlogApplication { public static void main(String[] args) { SpringApplication.run(BlogApplication.class, args); } }6. 让这个博客系统真正可用的3个进阶改造技巧6.1 给文章列表加全文搜索不用Elasticsearch的轻量方案MySQL 5.7原生支持全文索引比引入ES简单十倍。只需两步给blog表的title和content字段加FULLTEXT索引ALTER TABLE blog ADD FULLTEXT(title, content);在BlogMapper.xml中写MATCH AGAINST查询select idsearch resultTypeBlog SELECT * FROM blog WHERE MATCH(title, content) AGAINST(#{keyword} IN NATURAL LANGUAGE MODE) ORDER BY score DESC /select注意IN NATURAL LANGUAGE MODE适合中文分词需MySQL配置ft_min_word_len1而IN BOOLEAN MODE支持java -spring语法。测试时用SELECT MATCH(title, content) AGAINST(Java IN NATURAL LANGUAGE MODE) as score FROM blog验证得分是否合理。6.2 后台操作日志的零侵入埋点不想改每个Controller方法用Spring AOP切面记录日志Aspect Component public class AdminLogAspect { Around(annotation(org.springframework.web.bind.annotation.PostMapping) execution(* com.example.blog.controller.admin..*.*(..))) public Object logAdminAction(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long cost System.currentTimeMillis() - start; // 获取当前用户 HttpServletRequest request ((ServletRequestAttributes) RequestContextHolder.currentRequestAttributes()).getRequest(); User user (User) request.getSession().getAttribute(user); // 记录到数据库 AdminLog log new AdminLog(); log.setUserId(user.getId()); log.setUrl(joinPoint.getSignature().toShortString()); log.setCostTime(cost); log.setCreateTime(new Date()); adminLogMapper.insert(log); return result; } }关键点Around切所有PostMapping且包路径含admin的方法RequestContextHolder获取当前请求——这是Spring MVC线程安全的请求上下文。6.3 用Actuator暴露健康检查端点给运维看的加spring-boot-starter-actuator依赖后默认只开放/actuator/health。让运维能看数据库状态需在application.yml中加management: endpoints: web: exposure: include: health,info,metrics,env,threaddump endpoint: health: show-details: when_authorized info: java: enabled: true env: enabled: true然后访问http://your-server:8080/actuator/health返回{ status: UP, components: { db: { status: UP, details: { database: MySQL, validationQuery: isValid() } }, diskSpace: { status: UP, details: { total: 1234567890, free: 987654321 } } } }这才是运维真正需要的健康信号——不是{status:UP}这种玄学结果。我当年第一次部署时在/actuator/env里发现spring.profiles.activeprod没生效全是dev配置查了3小时才发现SPRING_PROFILES_ACTIVE环境变量没传进Docker容器。现在我的习惯是每次docker run后第一件事就是curl http://localhost:8080/actuator/env | grep active——这比看日志快十倍。希望帮到你。本文还有配套的精品资源点击获取 Java Web博客系统源码深度拆解与实战指南
简介这是一份面向Java Web初学者与课程设计者的完整博客系统实战源码适用于毕业设计、大作业及Web开发技能进阶学习。资源包含629个文件总大小18.43MB涵盖55个Java核心业务类、20个JSP动态页面、44个HTML前端结构页、35个JavaScript交互脚本、32个XML配置文件含web.xml与Spring相关配置、以及大量图片jpg/png/gif和样式资源CSS完整呈现MVC分层架构Controller层由Servlet与Action类驱动Service层封装业务逻辑DAO层实现数据库操作JSPELJSTL构成表现层配合MySQL常见表结构设计。已有676人学习下载可直接部署运行快速掌握用户管理、文章发布、评论互动、图片上传等典型功能模块并通过源码深入理解Java Web技术栈的协同机制与工程组织方式。1. 为什么一个“基于Java Web的博客系统源码.zip”值得你花3小时拆解它这不是又一个“Spring Boot Thymeleaf MySQL”的教学Demo。当你双击解压这个zip包看到src/main/java/com/example/blog/下整齐的controller/、service/、mapper/三层结构再翻到pom.xml里明确写着spring-boot-starter-web:2.7.18、mybatis-spring-boot-starter:2.2.5、thymeleaf:3.0.15.RELEASE——你就踩进了真实企业级Java Web项目的最小可行切片它没用Spring Security做RBAC但实现了带密码加密会话校验的登录没上Redis缓存文章列表但用Transactional锁住了评论并发插入连富文本编辑器都只集成了一版轻量级的simditor而非全功能CKEditor。它解决的是「小团队快速上线可维护博客」这个具体问题不是教你怎么写Hello World。适合刚做完SSM课程设计、正卡在「怎么把DAO层和Controller串成闭环」的Java后端新人也适合想给内部知识库搭个轻量后台、拒绝WordPress臃肿的运维同学。别急着跑起来——先看清它怎么用HttpServletRequest原生解析表单、怎么用PageHelper做分页而不暴露SQL、怎么把BlogEntity和BlogVO手动映射而不是靠MapStruct自动生成。这才是.zip里真正值钱的部分。2. 从解压到启动三步跑通这个Java Web博客系统的最小闭环2.1 解压后第一眼必须确认的4个关键文件打开zip包不要直接IDEA导入。先用文本编辑器看这四个文件pom.xml确认Spring Boot版本本项目为2.7.18不支持JDK17需用JDK8或JDK11检查mysql-connector-java是否为8.0.28注意驱动类名已从com.mysql.jdbc.Driver改为com.mysql.cj.jdbc.Driver确认thymeleaf-layout-dialect存在这是页面布局复用的关键。application.yml重点看spring.datasource.url是否含useSSLfalseserverTimezoneAsia/ShanghaiMySQL 8必加否则时区错乱导致发布时间全为0000-00-00mybatis.mapper-locations路径是否为classpath:mapper/*.xml本项目XML映射文件放在resources/mapper/下。schema.sql通常在src/main/resources/执行前先看建表语句——blog表有status tinyint(1) default 1字段但代码里没用枚举类约束而是硬编码1发布,0草稿后续扩展易出错。static/js/main.js搜索$.ajax调用确认所有POST请求头含X-Requested-With: XMLHttpRequest这是Spring Boot默认CSRF拦截器的放行条件漏了会导致403。提示如果pom.xml里出现scopeprovided/scope的javax.servlet-api依赖说明项目兼容Tomcat 9但本地用IDEA内置Tomcat 10会报jakarta.servlet包冲突——此时要么改用Tomcat 9要么把provided改成compile并排除传递依赖。2.2 本地数据库初始化绕过Hibernate自动建表的实操本项目禁用了JPA自动建表spring.jpa.hibernate.ddl-auto: none必须手动执行SQL。别直接复制schema.sql进MySQL客户端——里面混着INSERT INTO user (username, password)的测试数据而密码是明文123456。安全起见分三步操作-- 步骤1创建数据库字符集必须为utf8mb4 CREATE DATABASE blog_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 步骤2执行建表语句删掉所有INSERT语句只留CREATE TABLE -- 注意blog表的content字段类型是LONGTEXT不是TEXT避免超长文章截断 -- 步骤3手动插入管理员用户密码用BCrypt加密 INSERT INTO user (username, password, email, create_time) VALUES (admin, $2a$10$N9qo8uLOickgx2ZMRZoMy.eI0TtVvjozQYiOk2r4Wf0Yx9VzG5D1m, adminexample.com, NOW());密码加密逻辑在UserService.java的register()方法里BCryptPasswordEncoder().encode(rawPassword)。你可用以下Java片段生成新密码// 临时测试类运行后复制输出的BCrypt密文 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; public class PasswordEncoderTest { public static void main(String[] args) { String raw your_new_password; String encoded new BCryptPasswordEncoder().encode(raw); System.out.println(encoded); // 输出类似 $2a$10$... } }2.3 IDEA中启动项目的三个关键配置JDK版本锁定File → Project Structure → Project → SDK选JDK 11若用JDK 8需在pom.xml中将maven-compiler-plugin的source和target设为1.8Active Profiles设置Run → Edit Configurations → Environment variables里添加SPRING_PROFILES_ACTIVEdev项目application-dev.yml含本地数据库配置VM Options避坑添加-Dfile.encodingUTF-8 -Duser.timezoneGMT8否则Linux服务器部署时日志时间错乱。启动成功后访问http://localhost:8080首页应显示3篇测试文章访问http://localhost:8080/admin/login用admin/123456登录后台——注意密码是明文123456但数据库存的是BCrypt密文所以能登录成功。3. 登录功能深度拆解从表单提交到Session校验的完整链路3.1 前端登录表单的隐藏细节templates/login.html里的form标签看似普通form th:action{/admin/login} methodpost input typetext nameusername required/ input typepassword namepassword required/ button typesubmit登录/button /form但关键在th:action{/admin/login}生成的URL是/admin/login而LoginController.java中处理方法是PostMapping(/admin/login) public String login(RequestParam String username, RequestParam String password, HttpServletRequest request, Model model) { User user userService.login(username, password); // 1. 查询用户 if (user ! null) { request.getSession().setAttribute(user, user); // 2. 写入Session return redirect:/admin/index; // 3. 重定向 } else { model.addAttribute(error, 用户名或密码错误); return login; } }注意这里没用Spring Security的AuthenticationManager而是手写userService.login()——该方法先查数据库再用BCryptPasswordEncoder.matches()比对密码。好处是逻辑透明坏处是没集成Remember-Me或OAuth2扩展点。3.2 Session校验的两种实现方式对比项目在后台页面如/admin/write用两种方式校验登录态拦截器方式推荐AdminInterceptor.java实现HandlerInterceptor在preHandle()中检查request.getSession().getAttribute(user)是否为空。若为空response.sendRedirect(/admin/login)。Controller注解方式本项目实际用法每个后台接口方法开头加Object user request.getSession().getAttribute(user); if (user null) { return redirect:/admin/login; }为什么不用拦截器因为项目只有5个后台URL/admin/*硬编码成本更低。但如果你要加/api/*REST接口必须补拦截器——否则AJAX请求返回302重定向前端JS收不到JSON错误。3.3 密码加密与传输安全的实操补丁当前登录存在两个风险前端明文传输表单提交时密码未加密抓包可见明文无验证码防爆破连续输错10次不会锁定账号。补丁方案两行代码搞定在login.html底部加MD5加密仅防抓包非替代HTTPSscript srchttps://cdn.bootcdn.net/ajax/libs/blueimp-md5/2.19.0/js/md5.min.js/script script document.querySelector(form).onsubmit function() { const pwd document.querySelector([namepassword]); pwd.value md5(pwd.value); // 提交前哈希化 }; /script在UserService.login()方法里把数据库查出的密码密文传给matches()前先记录失败次数// 伪代码实际需加Redis或数据库计数 if (failedCount 5) { throw new RuntimeException(账号已被锁定请1小时后重试); }4. 文章管理模块的CRUD陷阱与性能优化点4.1 分页查询的PageHelper踩坑实录BlogController.list()方法用PageHelper实现分页GetMapping(/admin/blogs) public String list(Model model, RequestParam(defaultValue 1) int pageNum) { PageHelper.startPage(pageNum, 10); // 1. 开启分页 ListBlog blogs blogService.list(); // 2. 执行查询 PageInfoBlog pageInfo new PageInfo(blogs); // 3. 封装分页信息 model.addAttribute(pageInfo, pageInfo); return admin/blog_list; }表面没问题但PageHelper的startPage()必须紧挨着查询语句。如果service层有其他数据库操作如先查分类再查文章PageHelper会把前一个查询也分页正确写法是// ✅ 正确PageHelper.startPage()后立即跟Mapper查询 PageHelper.startPage(pageNum, 10); ListBlog blogs blogMapper.selectWithCategory(); // 直接调Mapper // ❌ 错误中间插了其他逻辑 PageHelper.startPage(pageNum, 10); categoryService.getAll(); // 这里触发了另一次查询 ListBlog blogs blogMapper.selectWithCategory(); // 分页失效4.2 富文本内容存储的边界处理simditor编辑器提交的内容含HTML标签如phello/p但BlogEntity.content字段在数据库是LONGTEXT。问题在于若用户粘贴含script的恶意代码后端没过滤就存库XSS风险若文章含大量图片img srcdata:image/png;base64,...会导致content字段超2GBMySQL单字段上限。解决方案入库前过滤在BlogService.save()中用Jsoup清洗String cleanContent Jsoup.clean(rawContent, Whitelist.relaxed() .addTags(img).addAttributes(img, src, alt, width, height));图片外链化修改simditor配置禁用base64上传强制走服务器上传接口simditor: { upload: { url: /admin/upload/image, params: null, fileKey: file, connectionCount: 3, leaveConfirm: 正在上传文件... } }后端UploadController.uploadImage()接收MultipartFile保存到static/upload/目录返回/upload/20240501/abc.jpg路径——这样content字段只存相对路径体积可控。4.3 评论并发插入的Transactional失效场景CommentController.add()方法标注了TransactionalTransactional PostMapping(/comment/add) public String addComment(RequestBody Comment comment, HttpServletRequest request) { User user (User) request.getSession().getAttribute(user); comment.setUserId(user.getId()); comment.setCreateTime(new Date()); commentMapper.insert(comment); // 插入评论 blogService.updateCommentCount(comment.getBlogId()); // 更新文章评论数 return success; }但如果updateCommentCount()抛异常评论仍会插入因为commentMapper.insert()和blogService.updateCommentCount()是两个独立事务后者没加Transactional或传播行为。修复方式// 在BlogService中加事务方法 Transactional public void updateCommentCountAndInsert(Comment comment) { commentMapper.insert(comment); updateCommentCount(comment.getBlogId()); // 此方法内不加Transactional }然后Controller调用blogService.updateCommentCountAndInsert(comment)——确保原子性。5. 部署到Linux服务器的5个血泪经验避坑指南5.1 现象启动后首页CSS/JS 404但控制台无报错原因Spring Boot静态资源路径默认为/static/**但Nginx反向代理时未配置location /static/指向jar包同级目录。解决在Nginx配置中加location /static/ { alias /var/www/blog/static/; # 指向jar包所在目录的static文件夹 expires 1h; }注意alias末尾必须有/且/var/www/blog/static/需提前创建并放好css/、js/文件夹。5.2 现象登录成功后跳转/admin/index却显示404原因Thymeleaf模板路径配置错误。application.yml中spring.thymeleaf.prefix: classpath:/templates/但admin/index.html实际在templates/admin/下而Controller返回admin/index时Thymeleaf会拼成classpath:/templates/admin/index.html——路径正确。真正问题是Linux文件系统大小写敏感Windows开发时文件名是Index.html但Linux服务器上是index.html导致找不到。解决统一用小写命名所有HTML文件并在IDEA中开启Settings → Editor → General → Sensitive case警告。5.3 现象MySQL连接池报Communications link failure原因阿里云RDS默认关闭wait_timeout8小时而HikariCP连接池的connection-test-query未配置空闲连接被RDS主动断开。解决在application-dev.yml中加spring: datasource: hikari: connection-test-query: SELECT 1 validation-timeout: 3000 idle-timeout: 600000 # 10分钟 max-lifetime: 1800000 # 30分钟小于RDS wait_timeout5.4 现象上传图片后访问/upload/xxx.jpg返回404原因Spring Boot默认不提供/upload/**静态资源映射。解决在WebMvcConfigurer实现类中加Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:/var/www/blog/upload/); // Linux绝对路径 }注意file:前缀不能省略且路径必须是绝对路径/var/www/blog/upload/相对路径upload/在Linux下会指向jar包所在目录而非你期望的位置。5.5 现象定时任务Scheduled不执行原因EnableScheduling注解漏加在主启动类上。解决检查BlogApplication.java是否有SpringBootApplication EnableScheduling // 必须有 public class BlogApplication { public static void main(String[] args) { SpringApplication.run(BlogApplication.class, args); } }6. 让这个博客系统真正可用的3个进阶改造技巧6.1 给文章列表加全文搜索不用Elasticsearch的轻量方案MySQL 5.7原生支持全文索引比引入ES简单十倍。只需两步给blog表的title和content字段加FULLTEXT索引ALTER TABLE blog ADD FULLTEXT(title, content);在BlogMapper.xml中写MATCH AGAINST查询select idsearch resultTypeBlog SELECT * FROM blog WHERE MATCH(title, content) AGAINST(#{keyword} IN NATURAL LANGUAGE MODE) ORDER BY score DESC /select注意IN NATURAL LANGUAGE MODE适合中文分词需MySQL配置ft_min_word_len1而IN BOOLEAN MODE支持java -spring语法。测试时用SELECT MATCH(title, content) AGAINST(Java IN NATURAL LANGUAGE MODE) as score FROM blog验证得分是否合理。6.2 后台操作日志的零侵入埋点不想改每个Controller方法用Spring AOP切面记录日志Aspect Component public class AdminLogAspect { Around(annotation(org.springframework.web.bind.annotation.PostMapping) execution(* com.example.blog.controller.admin..*.*(..))) public Object logAdminAction(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long cost System.currentTimeMillis() - start; // 获取当前用户 HttpServletRequest request ((ServletRequestAttributes) RequestContextHolder.currentRequestAttributes()).getRequest(); User user (User) request.getSession().getAttribute(user); // 记录到数据库 AdminLog log new AdminLog(); log.setUserId(user.getId()); log.setUrl(joinPoint.getSignature().toShortString()); log.setCostTime(cost); log.setCreateTime(new Date()); adminLogMapper.insert(log); return result; } }关键点Around切所有PostMapping且包路径含admin的方法RequestContextHolder获取当前请求——这是Spring MVC线程安全的请求上下文。6.3 用Actuator暴露健康检查端点给运维看的加spring-boot-starter-actuator依赖后默认只开放/actuator/health。让运维能看数据库状态需在application.yml中加management: endpoints: web: exposure: include: health,info,metrics,env,threaddump endpoint: health: show-details: when_authorized info: java: enabled: true env: enabled: true然后访问http://your-server:8080/actuator/health返回{ status: UP, components: { db: { status: UP, details: { database: MySQL, validationQuery: isValid() } }, diskSpace: { status: UP, details: { total: 1234567890, free: 987654321 } } } }这才是运维真正需要的健康信号——不是{status:UP}这种玄学结果。我当年第一次部署时在/actuator/env里发现spring.profiles.activeprod没生效全是dev配置查了3小时才发现SPRING_PROFILES_ACTIVE环境变量没传进Docker容器。现在我的习惯是每次docker run后第一件事就是curl http://localhost:8080/actuator/env | grep active——这比看日志快十倍。希望帮到你。本文还有配套的精品资源点击获取