1. 为什么选择SpringBoot开发个人博客第一次用SpringBoot搭建个人博客时我踩了不少坑。记得当时为了配置一个简单的分页功能折腾了整整两天。但现在回头看SpringBoot确实是Java开发者搭建个人项目的最佳选择。SpringBoot最大的优势就是开箱即用。你不用再为各种XML配置头疼内置的Tomcat服务器让部署变得异常简单。我实测过从零开始搭建一个基础博客框架用SpringBoot只需要15分钟而传统Spring MVC至少需要半天。对于个人博客这种中小型项目SpringBoot提供了恰到好处的功能组合内嵌数据库支持H2/SQLite开发阶段特别方便自动化的依赖管理starter系列依赖真香完善的文档生态遇到问题99%能在Stack Overflow找到答案2. 项目架构设计2.1 技术选型心得去年帮学弟调试他的毕业设计时发现很多初学者最容易犯的错误就是技术堆砌。明明是个个人博客非要上Spring Cloud全家桶。我的建议是用最合适的技术解决最核心的需求。这是我的技术选型方案- 核心框架SpringBoot 2.7.xLTS版本更稳定 - 模板引擎Thymeleaf比JSP优雅支持HTML原型 - 数据库MySQL 8.0开发版可用MariaDB替代 - ORMMyBatis-Plus省去80%的CRUD代码 - 前端组件Semantic UI jQuery轻量够用特别提醒新手常忽略的版本兼容性问题。比如SpringBoot 2.7.x默认集成的MyBatis版本是3.5.9如果手动引入3.4.0就会冲突。建议用Maven的dependency:tree命令检查依赖树。2.2 模块划分技巧我把博客系统拆分成这几个模块blog-core/ # 核心实体类 │ ├── entity/ │ ├── dto/ │ └── vo/ blog-admin/ # 后台管理 │ ├── controller/ │ ├── service/ │ └── mapper/ blog-web/ # 前端展示 │ ├── controller/ │ └── templates/ config/ # 配置类 │ ├── WebMvcConfig.java │ └── MyBatisConfig.java这种结构的好处是功能边界清晰改后台代码不会影响前端展示便于后期扩展比如想加API模块直接新建blog-api多人协作时冲突少不同人负责不同模块3. 核心功能实现3.1 用户认证方案对比我试过三种登录方案原生Session最简单但集群部署会出问题JWT无状态但注销机制复杂Spring Security功能强大但学习曲线陡峭最终选择Session拦截器的方案代码量最少且够用// 登录拦截器示例 public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getSession().getAttribute(user) null) { response.sendRedirect(/admin/login); return false; } return true; } }在WebMvcConfig中配置拦截路径Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/admin/**) .excludePathPatterns(/admin/login); }3.2 博客编辑器的坑Markdown编辑器我对比过Editor.md功能全但体积大800KBSimpleMDE已停止维护Toast UI Editor韩国产品中文文档少最终选择了TinyMCE虽然要付费但基础版免费够用。集成时要注意// 初始化配置要加这行否则中文会乱码 tinymce.init({ language: zh_CN, plugins: image code link, toolbar: undo redo | link image | code });上传图片需要单独处理PostMapping(/upload) ResponseBody public MapString, Object upload(RequestParam(file) MultipartFile file) { String url fileService.upload(file); return Map.of(location, url); // TinyMCE要求的返回格式 }4. 部署实战经验4.1 打包优化技巧默认的SpringBoot打包会包含所有依赖jar包往往50MB。通过配置可以瘦身build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId configuration excludes exclude groupIdorg.projectlombok/groupId artifactIdlombok/artifactId /exclude /excludes /configuration /plugin /plugins /build4.2 服务器配置最低配置建议1核CPU2GB内存40GB SSD关键配置项# 设置JVM参数 JAVA_OPTS-Xms512m -Xmx1024m -XX:MaxPermSize256m # 启动命令 nohup java -jar blog.jar --spring.profiles.activeprod log.out 21 遇到过最头疼的问题是内存泄漏后来用Arthas定位到是分页查询没关闭连接。推荐用Docker部署资源隔离更安全FROM openjdk:8-jdk-alpine VOLUME /tmp COPY target/blog.jar app.jar ENTRYPOINT [java,-jar,/app.jar]5. 性能优化方案5.1 缓存策略我的三级缓存方案本地缓存Caffeine高频访问的博客详情Redis缓存分类列表、热门文章数据库缓存MySQL查询缓存配置示例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; } }5.2 数据库优化给博客表加索引的教训-- 原来查询要2s SELECT * FROM articles WHERE category_id 5; -- 加上组合索引后200ms ALTER TABLE articles ADD INDEX idx_category_status (category_id, status);慢查询日志中发现分页是大坑// 错误写法性能差 PageHelper.startPage(1, 10); ListBlog list blogMapper.selectAll(); // 正确写法先分页再关联 PageHelper.startPage(1, 10); ListBlog list blogMapper.selectWithComments();6. 常见问题排查6.1 跨域问题前端报错Access-Control-Allow-Origin时后端要配置Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(GET, POST); } }6.2 静态资源404SpringBoot默认静态资源路径是classpath:/static/classpath:/public/如果放在resources/templates下会访问不到。建议统一管理spring: mvc: static-path-pattern: /assets/**7. 扩展功能实现7.1 评论楼中楼用parent_id实现层级关系public class Comment { private Long id; private Long articleId; private Long parentId; // 父评论ID private String content; private ListComment replies; // 子评论 }查询时使用递归select idselectByArticle resultMapcommentTree WITH RECURSIVE cte AS ( SELECT * FROM comment WHERE article_id#{articleId} AND parent_id0 UNION ALL SELECT c.* FROM comment c JOIN cte ON c.parent_idcte.id ) SELECT * FROM cte /select7.2 音乐播放器前端用APlayer插件link relstylesheet hrefhttps://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.css div idplayer/div script const ap new APlayer({ container: document.getElementById(player), audio: [{ name: 晴天, artist: 周杰伦, url: /music/sunny.mp3 }] }); /script8. 项目演进建议当博客访问量破万后可以考虑动静分离Nginx处理静态资源CDN加速图片等大文件走CDN读写分离MySQL主从架构消息队列异步处理邮件通知最简单的升级方案是改用Spring Cloud Alibaba但个人博客其实用不上微服务。我的经验是不要过度设计等真正遇到性能瓶颈再优化。