1. 为什么选择Spring Boot MyBatis构建个人博客系统在Java生态中构建个人博客系统时技术选型往往让人纠结。我最终选择Spring Boot MyBatis这套组合主要基于以下几个实际考量首先Spring Boot的自动配置特性让项目搭建变得极其简单。记得我第一次尝试用原生Spring MVC配置项目时光是处理各种XML配置就花了整整两天。而Spring Boot通过starter依赖和约定大于配置的原则让一个基础的Web应用能在5分钟内跑起来。对于个人博客这种中小型项目这种开发效率的提升是决定性的。MyBatis作为持久层框架相比Hibernate提供了更灵活的SQL控制能力。在博客系统中我们经常需要编写复杂的查询语句比如带有多重标签筛选的文章列表查询MyBatis的XML映射方式让这些复杂查询的实现变得直观。特别是在处理文章归档、分类统计这类需要优化SQL性能的场景时直接编写SQL的优势就更加明显。从架构分层角度看这套组合形成了清晰的MVC结构Spring Boot处理Web层ControllerMyBatis负责数据持久化Mapper业务逻辑自然落在Service层这种分层在博客系统的典型场景中表现优异。比如当用户发表评论时前端请求通过Spring MVC的RestController接收Service层处理评论内容过滤、通知等业务逻辑MyBatis将数据持久化到MySQL实际开发中发现MyBatis的动态SQL功能在处理博客文章的多条件查询时特别有用。比如根据分类、标签、发布时间等多个维度筛选文章用MyBatis的 标签可以优雅地构建动态WHERE条件。2. 项目基础架构搭建2.1 初始化Spring Boot项目我使用Spring Initializrstart.spring.io生成项目骨架关键依赖选择Spring Web构建RESTful APIMyBatis Framework集成MyBatisMySQL Driver数据库连接Lombok简化实体类代码pom.xml中特别注意了依赖版本管理。近期Spring Boot 3.x有一些破坏性变更考虑到生态成熟度我选择了当前企业主流的2.7.x版本parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.15/version /parent2.2 数据库设计博客系统的核心表包括表名主要字段说明articleid, title, content, view_count, create_time文章主体表categoryid, name文章分类tagid, name标签article_tagarticle_id, tag_id文章-标签关联commentid, content, article_id, parent_id评论表在MySQL中建表时有几个关键设计点值得注意文章表使用自增主键同时在slug字段添加唯一索引用于生成友好URL评论表设计为树形结构通过parent_id实现回复嵌套为view_count等频繁更新的字段单独设计更新接口避免每次更新整篇文章2.3 MyBatis集成配置application.yml中配置数据源和MyBatisspring: datasource: url: jdbc:mysql://localhost:3306/blog?useSSLfalseserverTimezoneUTC username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.blog.model在实测中发现MyBatis的N1查询问题在博客系统的关联查询中容易发生。比如查询文章列表时如果同时需要获取每篇文章的标签采用懒加载会导致大量额外查询。我的解决方案是使用 定义复杂的关联映射在XML中通过JOIN一次性获取所有需要的数据对于不常用的关联字段如文章详情中的评论列表仍然保持懒加载3. 核心功能实现细节3.1 文章发布模块文章发布的Controller设计RestController RequestMapping(/api/articles) public class ArticleController { PostMapping public Result publishArticle(Valid RequestBody ArticleDTO dto) { return articleService.createArticle(dto); } // 其他接口... }这里使用了DTO模式来接收前端数据与数据库实体分离。ArticleDTO中包含了基本的校验注解public class ArticleDTO { NotBlank(message 标题不能为空) Size(max 100, message 标题长度不能超过100字符) private String title; NotBlank(message 内容不能为空) private String content; // 其他字段... }在Service层实现中特别注意了事务处理。一篇文章的发布可能涉及多个数据库操作插入文章主表处理标签关联新增不存在的标签更新分类统计信息因此需要使用Transactional注解保证原子性Service RequiredArgsConstructor public class ArticleServiceImpl implements ArticleService { private final ArticleMapper articleMapper; private final TagMapper tagMapper; Transactional public Result createArticle(ArticleDTO dto) { // 1. 保存文章主体 Article article convertToEntity(dto); articleMapper.insert(article); // 2. 处理标签 processTags(article.getId(), dto.getTags()); // 3. 更新分类计数 updateCategoryCount(dto.getCategoryId()); return Result.success(article.getId()); } }3.2 评论系统实现评论模块有几个技术难点需要特别注意XSS防护用户输入的评论内容需要过滤HTML标签敏感词过滤实时检测不当内容树形结构存储支持评论回复功能我的实现方案是public class CommentServiceImpl implements CommentService { private static final ListString SENSITIVE_WORDS Arrays.asList(敏感词1, 敏感词2); public Result addComment(CommentDTO dto) { // XSS过滤 String cleanContent HtmlUtils.htmlEscape(dto.getContent()); // 敏感词检测 if(containsSensitiveWord(cleanContent)) { throw new BusinessException(评论包含不当内容); } Comment comment new Comment(); comment.setContent(cleanContent); comment.setArticleId(dto.getArticleId()); comment.setParentId(dto.getParentId()); commentMapper.insert(comment); // 更新文章评论数 articleMapper.incrementCommentCount(dto.getArticleId()); return Result.success(comment.getId()); } }对于树形结构的展示在Mapper.xml中使用递归查询select idselectByArticleId resultMapcommentResultMap WITH RECURSIVE comment_tree AS ( SELECT * FROM comment WHERE article_id #{articleId} AND parent_id IS NULL UNION ALL SELECT c.* FROM comment c JOIN comment_tree ct ON c.parent_id ct.id ) SELECT * FROM comment_tree ORDER BY create_time DESC /select3.3 文章搜索功能虽然小型博客可以直接使用数据库LIKE查询但考虑到性能我集成了Elasticsearch实现全文检索。关键步骤如下添加Spring Data Elasticsearch依赖定义文章索引结构实现同步数据库到ES的机制Elasticsearch的文档模型Document(indexName articles) public class ArticleDocument { Id private Long id; Field(type FieldType.Text, analyzer ik_max_word) private String title; Field(type FieldType.Text, analyzer ik_max_word) private String content; // 其他字段... }使用Async实现异步索引更新Service public class SearchServiceImpl implements SearchService { private final ArticleDocumentRepository repository; Async public void updateIndex(Article article) { ArticleDocument doc convertToDocument(article); repository.save(doc); } }4. 性能优化与生产准备4.1 缓存策略设计博客系统的读多写少特性非常适合使用缓存。我的缓存方案分为三层本地缓存使用Caffeine缓存热点文章Redis缓存存储完整的文章HTML渲染结果数据库原始数据存储Spring Cache的配置示例Configuration EnableCaching public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineCacheManager manager new CaffeineCacheManager(); manager.setCaffeine(Caffeine.newBuilder() .expireAfterWrite(10, TimeUnit.MINUTES) .maximumSize(1000)); return manager; } }在Service层使用缓存注解Cacheable(value article, key #id) public Article getArticleById(Long id) { return articleMapper.selectById(id); } CacheEvict(value article, key #article.id) public void updateArticle(Article article) { articleMapper.updateById(article); }4.2 静态资源处理博客系统的图片等静态资源采用CDN加速方案上传图片到阿里云OSS通过CDN分发在前端使用WebP格式的图片Spring Boot中配置资源处理Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/static/**) .addResourceLocations(classpath:/static/) .setCacheControl(CacheControl.maxAge(365, TimeUnit.DAYS)); } }4.3 监控与日志生产环境必须添加监控和日志集成Spring Boot Actuator配置Prometheus监控指标使用Logback记录结构化日志application.yml中的关键配置management: endpoints: web: exposure: include: health,info,metrics,prometheus metrics: tags: application: ${spring.application.name} logging: pattern: console: %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n file: path: ./logs name: blog.log5. 开发过程中的经验总结在完成这个博客系统的过程中我积累了一些值得分享的经验MyBatis的TypeHandler使用对于文章内容这种大文本字段我自定义了TypeHandler来压缩存储。实现后发现查询性能下降了15%后来改为只在内容超过一定长度时才压缩取得了较好的平衡。Spring Boot的多环境配置通过profile区分开发、测试和生产环境。一个容易忽略的点是测试环境的MyBatis SQL日志需要单独配置spring: profiles: test logging: level: com.example.blog.mapper: debug前端与后端的协作定义清晰的API文档非常重要。我使用Swagger UI自动生成API文档并通过GitHub Wiki维护更详细的需求说明。部署时的坑第一次部署时遇到静态资源404的问题发现是Nginx配置需要特别处理前端路由location / { try_files $uri $uri/ /index.html; }缓存一致性问题当文章更新后发现缓存没有及时失效。最终解决方案是使用Redis的Pub/Sub机制在数据变更时发布消息所有实例同步清除缓存。这个博客系统从技术角度看并不复杂但要把每个细节都处理好确实需要不少经验积累。特别是在性能优化方面需要根据实际访问量不断调整策略。下一步我计划加入用户行为分析功能基于阅读习惯推荐相关文章让系统更加智能化。