服务端渲染（SSR）技术选型

适用场景：个人博客访客站（SEO、首屏、简单交互）
当前项目：Spring Boot 3.5 + Thymeleaf + MyBatis-Plus；管理后台为独立 SPA（/console）+ REST API（/api/admin）

1. 什么是服务端渲染

本博客访客站采用 SSR：爬虫与弱网环境可直接拿到正文；管理后台采用 CSR：交互复杂、无需 SEO。

2. 选型维度

3. 方案对比（Java / Spring 生态为主）

3.1 服务端模板引擎（推荐用于本博客）

3.2 前端框架 SSR（Node 运行时）

3.3 静态站点生成（SSG）

3.4 混合架构

4. 与本项目相关的结论

4.1 访客站：Thymeleaf SSR ✅

选择理由：

1. 技术栈统一：Controller → Service → MyBatis-Plus → Thymeleaf，无 Node 进程。
2. SEO 友好：文章标题、摘要、导航在服务端写入 HTML。
3. 部署简单：与现有 Docker + Nginx 反代一致，无需额外 SSR 服务。
4. 已落地：layout:decorate、分页列表、分类/标签/归档页均已模板化。

配套实践：

• 生产开启 spring.thymeleaf.cache=true（application-prod.yaml）。
• 静态资源走 /static/**，与 /console 下 SPA 资源路径隔离。
• 反向代理设置 X-Forwarded-Proto，保证 HTTPS 链接正确。

4.2 管理后台：CSR（SPA）✅

不采用 SSR 的原因：

• 无需被搜索引擎收录。
• 表单、表格、鉴权状态适合 SPA + REST。
• 与访客站解耦，发布后台不影响博客缓存策略。

部署注意：

• 构建时 assetPrefix: '/console/'，避免静态资源请求到站点根路径 /static/（与博客冲突）。

4.3 未选用方案及原因

5. 架构示意

                    ┌─────────────────────────────────────┐
                    │           Nginx (443)               │
                    └─────────────────────────────────────┘
                          │              │           │
              /           │    /api/     │  /console/
                          ▼              ▼           ▼
              ┌───────────────────┐   同左      静态 dist
              │  Spring Boot :8080 │◄─────────  (Rsbuild)
              │                   │
              │  Thymeleaf SSR    │  REST /api/admin/**
              │  /  /post/*.html  │
              └─────────┬─────────┘
                        ▼
                    MySQL

6. 性能与 SEO checklist

• [ ] 文章页 <title>、<meta name="description"> 由服务端注入
• [ ] 列表页分页链接使用真实 URL（/category/xxx.html），非纯 #
• [ ] 生产开启 Thymeleaf 模板缓存
• [ ] 图片/ CSS 设置合理缓存头（Nginx expires）
• [ ] 管理接口与公开页分离路径，避免误缓存 API
• [ ] 可选：站点地图 sitemap.xml、RSS（可后续 Controller 生成）

7. 何时需要重新评估

8. 版本与依赖（当前仓库）

9. 一句话总结

个人 Java 博客：访客站用 Thymeleaf 做服务端渲染，管理端用 SPA + REST；在 SEO、运维简单和栈统一之间平衡最好，无需为 SSR 单独引入 Node 全栈框架。