Java初学者项目实战:创建一个简单的博客平台

初学者应优先用Spring Boot搭建博客平台,选用H2内存数据库、Thymeleaf模板和Spring Security内存认证,聚焦增删改查闭环,跳过复杂功能。

Java初学者项目实战:创建一个简单的博客平台 这个目标听起来合理,但实际动手时会立刻撞上几个硬门槛——**不是语法不会,而是不知道从哪一层开始搭、哪些组件能省、哪些必须自己写**。 Spring Boot 是当前最现实的选择,它能绕过大量 XML 配置和容器部署问题

。但即便用 Spring Boot,初学者也容易在三件事上卡住:数据存哪、页面怎么渲染、用户怎么登录。下面直奔这三块。

用 H2 数据库快速建模,别碰 MySQL 一开始

本地开发阶段硬上 MySQL,90% 的时间花在装驱动、配 application.properties、处理时区错误或连接拒绝上。H2 是纯 Java 内存数据库,启动即用,支持 SQL 标准,且能自动生成表结构。

实操建议:

  • pom.xml 中只加这两个依赖:spring-boot-starter-data-jpah2
  • application.properties 里写死这三行:
    spring.datasource.url=jdbc:h2:mem:testdb
    spring.datasource.driver-class-name=org.h2.Driver
    spring.h2.console.enabled=true
  • 实体类用 @Entity + @Id + @GeneratedValue 就够;JPA 会自动建表,不用手写 DDL
  • H2 控制台地址是 http://localhost:8080/h2-console,填完 JDBC URL(同上面)就能查数据,比写 DAO 测试快得多

Thymeleaf 模板比 REST + Vue 更适合练手

想“看到博客页面”,不代表非得前后端分离。对初学者来说,用 Thymeleaf 直接返回 HTML 页面,能一次性理清请求路径、模型传递、模板变量绑定三者关系。

常见错误现象:

  • 页面 404:没在 src/main/resources/templates/ 下放 index.html,或 Controller 返回的字符串和文件名不一致
  • 变量不渲染:忘了在 HTML 头部加 xmlns:th="http://www.thymeleaf.org"
  • 样式失效:静态资源(CSS/JS)必须放在 src/main/resources/static/,不是 templates

示例 Controller 片段:

@Controller
public class BlogController {
    @GetMapping("/")
    public String home(Model model) {
        model.addAttribute("posts", List.of(
            Map.of("title", "我的第一篇博客", "content", "Hello World")
        ));
        return "index"; // 对应 templates/index.html
    }
}

登录功能先用 Spring Security 内存用户,跳过数据库认证

真实博客要存用户密码、做盐值哈希、防暴力破解……这些全是干扰项。初学阶段,目标是让“登录后能看到发布按钮”,而不是实现安全体系。

实操建议:

  • 加依赖 spring-boot-starter-security,其他什么都不配,它会自动启用基础 HTTP 认证,用户名是 user,密码在启动日志里找 Using generated security password
  • 想自定义账号?在 SecurityConfig 里重写 configure(AuthenticationManagerBuilder auth),用 auth.inMemoryAuthentication().withUser("admin").password("{noop}123").roles("USER")
  • {noop} 表示明文密码(仅限学习),千万别删掉大括号,否则报 PasswordEncoder 错误
  • Thymeleaf 模板里用 sec:authorize="isAuthenticated()" 判断是否登录(需引入 thymeleaf-extras-springsecurity5

别急着加“标签”“分类”“评论”——先跑通增删改查闭环

很多初学者一上来就设计五张表、画 ER 图、纠结外键级联,结果连保存一篇博文都报 NullPointerException。真正卡点往往是:表单 POST 数据没绑定到对象、Redirect 后 Model 丢失、删除时没处理关联数据导致外键异常。

优先验证这四件事:

  • GET /post/new → 显示空白表单
  • POST /post → 接收 @ModelAttribute Post post 并存入数据库
  • GET /post/{id} → 查一条并渲染详情页
  • POST /post/{id}/delete → 用 @PathVariable 取 ID,调 repository.deleteById(id)

每一步都用浏览器直接发请求测试(Postman 或 curl),别等全写完再调试。Spring Boot 的 CrudRepository 已经帮你写了增删改查方法,别重复造轮子。

真正难的从来不是“怎么写”,而是“哪部分可以暂时不写”。比如 Markdown 渲染、图片上传、分页、SEO 标签——这些全都可以留到第二版再碰。第一版只要求:能输入标题和内容、点击保存、刷新页面看到新文章、点删除就消失。做到这个,你就已经跨过了从教程到项目的那道墙。