初学者应直接使用Spring Boot+Thymeleaf+H2+JPA搭建博客系统,避免手写MVC和数据库连接池;需正确配置主键注解、表单绑定及application.properties,重点关注日志末尾的Caused by错误。

Java初学者做博客管理系统,不建议从零手写全套 MVC 架构、数据库连接池、权限控制——那样容易卡在 ClassNotFoundException 或 SQLException: No suitable driver found 三天没跑出首页。直接用 Spring Boot + Thymeleaf + H2(开发阶段)+ JPA 是最务实的起点。
用 Spring Boot 初始化项目,别碰原始 Servlet
手动配 web.xml、写 HttpServlet 子类、自己解析 POST 表单——这些不是练手,是自设路障。Spring Boot 的 @RestController 和 @Controller 能把路由、参数绑定、JSON 返回全包圆。
实操建议:
- 去 start.spring.io 勾选:
Spring Web、Spring Data JPA、Thymeleaf、H2 Database(开发用)、Lombok(省掉 getter/setter) - 生成后导入 IDE,确认
pom.xml里有spring-boot-starter-web和spring-boot-starter-data-jpa - 删掉默认的
Application.java里的测试逻辑,先跑通空项目:启动后访问http://localhost:8080看是否返回 Whitelabel Error Page(说明容器已起来)
定义 Blog 实体类时,JPA 注解别漏掉 @Id 和 @GeneratedValue
很多初学者写完 Blog 类,加了 @Entity 就以为完事,结果启动报错:org.hibernate.AnnotationException: No identifier specified for entity。JPA 必须明确主键策略。
立即学习“Java免费学习笔记(深入)”;
正确写法示例(用 Lombok 简化):
@Entity
public class Blog {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String title;
private String content;
private LocalDateTime createdAt;
// 构造、getter/setter(Lombok 自动生成)
}
注意点:
-
GenerationType.IDENTITY对应 H2 的IDENTITY列类型,别写成AUTO(H2 不支持) -
LocalDateTime需要数据库列类型为TIMESTAMP,H2 默认支持;若换 MySQL,需在application.properties加spring.jpa.properties.hibernate.jdbc.time_zone=UTC避免时区错乱 - 别给
id字段加@Column(name = "id")——冗余,JPA 默认就映射同名字段
Thymeleaf 模板里写 th:object 和 th:field,别混用 th:value
想做一个新建博客的表单,写成这样会失败:
问题在于:th:value 和 th:text 不绑定对象属性,提交时后端收不到数据;且没启用 Spring 的表单绑定机制,@ModelAttribute 参数为空。
正确写法(必须配对使用):
关键点:
-
th:object指定绑定对象(传入 Model 的 key,如model.addAttribute("blog", new Blog())) -
th:field="*{xxx}"自动渲染name="xxx"并填入值,还支持错误提示(配合BindingResult) - 别用
th:name手动写 name 属性——破坏双向绑定,后端收不到
调试时优先查 application.properties 和日志末尾的 Caused by
启动失败八成不是代码写错,而是配置漏项或版本冲突。比如:
- 忘了在
application.properties写spring.datasource.url=jdbc:h2:mem:testdb→ 报Failed to configure a DataSource - H2 控制台默认关闭 → 想看数据库内容却打不开
http://localhost:8080/h2-console,得加spring.h2.console.enabled=true - 实体类改了字段但没清 H2 内存库 → 页面报
InvalidDataAccessResourceUsageException: Column "XXX" not found,此时删掉spring.datasource.url末尾的;DB_CLOSE_DELAY=-1并重启,或加spring.sql.init.mode=always重跑 schema
日志里真正有用的线索永远在最后一段 Caused by:,而不是开头几百行的 Hibernate 启动日志。盯住它,比反复改代码快十倍。










