Java项目网站≠Spring Boot启动页，应将网站视为前端单页应用，后端仅提供元数据API，静态资源放src/main/resources/static/，数据与视图分离，避免硬编码，注意Nginx MIME类型配置。
Java项目网站 ≠ Spring Boot 启动页
很多人用 spring-boot-starter-web 跑通一个 /hello 接口，就以为“Java项目网站”做完了。其实不是——展示型网站的核心是「静态内容可维护、项目信息能自动同步、部署不依赖后端渲染逻辑」。Spring Boot 默认的 Thymeleaf 或 JSP 模板方案，在这类场景里反而增加复杂度和维护成本。
用 Spring Boot 静态资源目录 + 前端构建流程最稳妥
把网站当成「前端单页应用」来组织，后端只提供项目元数据接口（比如 JSON 列表），其余全由 HTML/CSS/JS 渲染。这样既能用 Java 管理项目数据源（如读取 projects.yaml 或查数据库），又避免模板引擎带来的路径、缓存、SEO 问题。
-
src/main/resources/static/放index.html、projects.js、style.css - 前端用
fetch('/api/projects')拉取 JSON，用 JS 动态生成卡片列表 - 后端写一个
@RestController返回List<Project>，Spring Boot 自动序列化为 JSON - 不用配置
WebMvcConfigurer，默认静态资源路径已支持/映射到index.html
项目数据别硬编码在 HTML 里
展示型网站最常被忽略的一点：项目信息变一次，就得改 HTML、提 PR、重新部署。应该让数据和视图分离。推荐两种轻量方式：
大规模构建程序化 SEO 2.0 系统——采用严格定义的 JSON Schema、垂直领域分类体系（niche taxonomy）及 React 渲染器实现 AI 生成内容。适用于以下场景：(1) 创建海量…
- 用
src/main/resources/projects.json，启动时由@PostConstruct加载进内存，API 直接返回它——适合小规模、更新不频繁的站点 - 用
@Value("classpath:projects.yaml")配合YamlPropertiesFactoryBean，比 JSON 更易人工编辑（注意缩进和冒号空格） - 如果项目信息来自 Git 仓库（如 GitHub repos API），建议加一层缓存（
@Cacheable），避免首页打开慢或触发限流
部署时别漏掉静态资源 MIME 类型配置
本地跑得好，上线 404 或 CSS 不生效？大概率是反向代理（Nginx / Cloudflare）没正确设置 .js、.css 的 Content-Type。Spring Boot 内置 Tomcat 默认能识别常见类型，但一旦前面加了 Nginx，且没配 include mime.types;，就会返回 text/plain，浏览器直接拒解析。
立即学习“Java免费学习笔记（深入）”；
location / {
root /var/www/my-java-projects;
try_files $uri $uri/ /index.html;
}
# 必须有这一行，否则 .js/.css 可能被当纯文本
include mime.types;另外，index.html 里引用的 projects.js 如果用了相对路径（如 ./data/projects.js），而实际部署结构是扁平的（所有文件都在根目录），路径错位会导致白屏——这种细节调试起来特别花时间。
