尧图网页设计 
简介这是一份面向Java初学者与课程设计学生的个人信息维护系统完整项目源码以Java后端开发为核心结合网页设计与数据库操作帮助读者掌握从登录验证到信息管理的完整Web应用开发流程。压缩包共78个文件约1.24MB包含8个Java源文件、42个XML配置、5个CSS与5个JS前端资源以及2个SQL建表脚本、properties配置、html页面和课程设计报告文档覆盖后端逻辑、前端样式与数据库脚本各环节。系统涵盖用户登录、个人信息展示与修改、登录历史表格显示等模块涉及JDBC连接、SQL增删改查、MVC分层设计及密码加密等知识点适合作为课程设计或自学练手项目。目前已有100人学习下载读者可据此理解项目结构、数据库表设计与前后端交互思路并在此基础上扩展异常处理与安全性优化。1. 从一份 Java 个人信息维护系统源码说起它到底能跑通什么很多人拿到「基于 Java 设计的个人信息维护系统.zip」这类资源第一反应是解压、找 main 方法、点运行然后卡在数据库连不上或者页面 404。我拆过不少同类型的管理系统源码这类项目的定位其实很清晰它是一个典型的 Java Web 单体应用核心业务围绕「人」的信息做增删改查附带登录鉴权、分页列表、条件检索这些管理后台的标配能力。它解决的不是高并发场景而是让你有一套结构完整、能二次开发的 CRUD 骨架。适合谁用如果你正在学 Java Web 的完整链路想找一个能跑通「浏览器请求 → Controller → Service → DAO → 数据库 → 页面渲染」全流程的练手项目这份源码的价值就在这里。它比你自己从零搭一个 Spring Boot 空壳要省事因为表结构、实体类、前端页面都给你了。但如果你指望它直接上线扛生产流量那得先看清楚它的技术栈和分层设计再决定。下面我按「先搞懂结构、再动手跑通、最后避开坑」的顺序把这份资源拆开讲。2. 拆解项目结构与技术栈先搞清楚它靠什么跑起来2.1 典型分层与依赖关系这类个人信息维护系统常见做法是 Spring Boot MyBatis或 MyBatis-Plus MySQL Thymeleaf/JSP 的组合。为什么这么选因为 Spring Boot 省去了大量 XML 配置MyBatis 对 SQL 的控制力比 JPA 更直接适合管理系统里那些带多条件筛选的查询。前端如果用 Thymeleaf页面和 Java 代码耦合度低改起来不用重新编译整个前端工程。拿到源码后先别急着导入 IDE。我一般会先看三个地方pom.xml里的依赖版本、application.yml或.properties里的数据源配置、以及src/main/resources下有没有 SQL 初始化脚本。这三样决定了你能不能顺利跑起来。# 先看项目根目录结构确认构建方式 ls -la # 如果是 Maven 项目会有 pom.xmlGradle 项目则是 build.gradle # 再看资源目录里有没有建表语句 find . -name *.sql -o -name schema.sql -o -name data.sql上面这几条命令的作用是快速定位项目的构建工具和数据库初始化方式。pom.xml存在说明是 Maven 项目后续用mvn命令操作*.sql文件如果存在说明作者已经把建表语句准备好了你只需要在 MySQL 里执行一遍。如果没找到 SQL 文件那就得根据实体类反推表结构这一步后面会讲。2.2 实体类与表结构的对应关系管理系统类项目的实体类通常放在entity或domain包下字段和数据库列一一对应。常见做法是用 MyBatis-Plus 的注解来映射比如TableName、TableId、TableField。如果你拿到的项目没有 SQL 脚本可以根据实体类手动建表或者用 MyBatis-Plus 的代码生成器反向生成。// 典型的用户信息实体类结构 Data TableName(user_info) public class UserInfo { TableId(type IdType.AUTO) private Long id; // 主键自增 private String name; // 姓名 private String phone; // 手机号 private String email; // 邮箱 private String address; // 地址 TableField(fill FieldFill.INSERT) private LocalDateTime createTime; // 创建时间自动填充 }这段代码里TableName指定了对应的数据库表名TableId的IdType.AUTO表示主键由数据库自增生成。TableField(fill FieldFill.INSERT)是 MyBatis-Plus 的自动填充功能插入时自动写入当前时间省去手动 set 的麻烦。如果你用的不是 MyBatis-Plus 而是原生 MyBatis那这些注解就不存在需要靠 XML 映射文件或注解 SQL 来维护字段关系。参数说明IdType.AUTO适合 MySQL 的自增主键如果用的是 Oracle 序列或 UUID要改成对应的策略。FieldFill.INSERT只在插入时生效更新时想自动填充得用FieldFill.INSERT_UPDATE。2.3 配置文件里的关键参数application.yml是跑通项目的命门。数据库连接、端口、日志级别都在这里。我见过太多人因为没改数据源配置启动直接报Communications link failure。server: port: 8080 # 服务端口被占用就改成 8081 或别的 spring: datasource: url: jdbc:mysql://localhost:3306/personal_info?useSSLfalseserverTimezoneAsia/Shanghai username: root # 改成你本地 MySQL 的用户名 password: your_password # 改成你本地 MySQL 的密码 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发阶段关掉缓存改页面不用重启 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印 SQL方便调试url里的serverTimezoneAsia/Shanghai是必须的否则 MySQL 8.x 会报时区错误。useSSLfalse在本地开发时关掉 SSL 省事生产环境要开。log-impl配成StdOutImpl后每次查询都会在控制台打印实际执行的 SQL调条件筛选的时候特别有用。thymeleaf.cachefalse只在开发阶段设上线要改回true不然每次渲染都读磁盘性能会掉。3. 从零跑通系统环境准备与启动步骤3.1 环境版本对齐在动手之前先把版本对齐。这类项目对版本比较敏感JDK 8 和 JDK 17 跑起来可能完全不一样。常见做法是如果pom.xml里写的java.version是 1.8那就用 JDK 8如果是 17那就用 17。MySQL 建议用 5.7 或 8.0两者在驱动类名上有区别——5.7 用com.mysql.jdbc.Driver8.0 用com.mysql.cj.jdbc.Driver。组件推荐版本说明JDK8 或 17看 pom.xml 里的 source/targetMySQL5.7 / 8.08.0 需要配时区Maven3.6用于依赖下载和打包IDEIDEA / EclipseIDEA 对 Spring Boot 支持更好3.2 建库建表与数据初始化如果项目里有 SQL 脚本直接导入。没有的话根据实体类手写建表语句。下面是一个通用的用户信息表结构字段可以根据实体类增减。CREATE DATABASE IF NOT EXISTS personal_info DEFAULT CHARACTER SET utf8mb4; USE personal_info; CREATE TABLE user_info ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) COMMENT 手机号, email VARCHAR(100) COMMENT 邮箱, address VARCHAR(200) COMMENT 地址, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;utf8mb4而不是utf8是因为前者支持完整的 Unicode 字符包括 emoji。ENGINEInnoDB支持事务和外键管理系统里如果涉及多表操作InnoDB 是必须的。create_time给了默认值CURRENT_TIMESTAMP这样即使代码里没设数据库也会自动填。3.3 启动与验证配置改完后用 Maven 启动。如果是 Spring Boot 项目直接跑主类或者用命令。# 在项目根目录执行跳过测试加快启动 mvn spring-boot:run -DskipTests # 或者先打包再运行 mvn clean package -DskipTests java -jar target/*.jar启动成功后控制台会打印Started Application in x.x seconds。这时候打开浏览器访问http://localhost:8080应该能看到登录页或首页。如果 404检查 Controller 里的RequestMapping路径和 Thymeleaf 模板存放位置是否匹配。如果登录后报数据库错误回头看application.yml里的库名、用户名、密码是否和本地一致。提示第一次启动如果卡在下载依赖检查 Maven 的settings.xml是否配了国内镜像。依赖下载不全会导致编译失败报ClassNotFoundException。4. 二次开发与功能扩展改哪里、怎么改4.1 新增字段的完整链路管理系统最常见的二次开发就是加字段。比如要在用户信息里加一个「身份证号」需要改四个地方数据库表加列、实体类加属性、Mapper XML如果用原生 MyBatis加映射、前端页面加输入框。用 MyBatis-Plus 的话Mapper XML 可以省掉但实体类和页面必须改。// 实体类新增字段 private String idCard; // 身份证号 // Controller 里接收参数时如果是对象绑定不用改 // 如果是单独接收要加 RequestParam!-- Thymeleaf 页面新增输入框 -- div classform-group label身份证号/label input typetext th:field*{idCard} classform-control / /div实体类加字段后MyBatis-Plus 会自动把idCard映射成id_card驼峰转下划线前提是mybatis-plus.configuration.map-underscore-to-camel-case为true默认就是。页面里的th:field*{idCard}会自动绑定表单对象提交时 Spring MVC 自动封装。4.2 条件查询与分页的实现管理系统的列表页通常带搜索框和分页。MyBatis-Plus 提供了QueryWrapper和Page对象几行代码就能搞定。// Service 层分页查询示例 public IPageUserInfo searchUsers(int pageNum, int pageSize, String keyword) { PageUserInfo page new Page(pageNum, pageSize); QueryWrapperUserInfo wrapper new QueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(name, keyword) .or() .like(phone, keyword); } wrapper.orderByDesc(create_time); return userInfoMapper.selectPage(page, wrapper); }Page对象封装了当前页和每页条数selectPage返回的结果里包含总记录数和当前页数据。QueryWrapper的like方法生成LIKE %keyword%or()连接多个条件。注意orderByDesc(create_time)用的是数据库列名不是 Java 属性名。如果字段名和列名不一致这里要写列名。参数说明pageNum从 1 开始不是 0pageSize别设太大管理系统一般 10 到 20 条一页就够设成 1000 会把数据库拖慢。4.3 登录鉴权的常见实现这类项目通常有一个简单的登录拦截。常见做法是用 Session 存用户信息配合一个HandlerInterceptor做拦截。// 拦截器配置 Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/login, /css/**, /js/**); } }addPathPatterns(/**)拦截所有请求excludePathPatterns放行登录页和静态资源。LoginInterceptor里判断 Session 中是否有用户对象没有就重定向到登录页。这种方案简单直接但要注意静态资源路径别被拦了否则页面样式全丢。5. 避坑与排查那些让我重启了十几次的问题5.1 启动报数据库连接失败现象控制台抛Communications link failure或Access denied for user。原因application.yml里的用户名、密码、库名和本地 MySQL 不一致或者 MySQL 服务没启动。解决先用命令行mysql -u root -p确认能登录再核对配置文件。如果是 8.0 版本检查url里有没有serverTimezone。5.2 页面 404 或模板找不到现象浏览器访问返回 404或者报TemplateInputException。原因Thymeleaf 模板默认放在src/main/resources/templates下Controller 返回的视图名要和文件名对应。如果用了 JSP路径配置又不一样。解决检查Controller类里方法的返回值比如return user/list对应templates/user/list.html。文件扩展名和目录层级都要对上。5.3 中文乱码现象页面输入中文存到数据库变成问号或者页面显示乱码。原因数据库字符集不是utf8mb4或者连接 URL 没指定编码。解决建库时用DEFAULT CHARACTER SET utf8mb4连接 URL 加characterEncodingutf8。Thymeleaf 页面头部加meta charsetUTF-8。5.4 修改代码后不生效现象改了 Java 代码或页面重启后还是旧内容。原因Thymeleaf 缓存没关或者 IDE 没有自动编译。解决application.yml里设spring.thymeleaf.cachefalseIDEA 里开启Build project automatically。改 Java 代码必须重启改 HTML 可以刷新。5.5 分页查询返回空数据现象列表页有数据但翻到第二页就空了。原因Page对象的pageNum传了 0或者 SQL 里LIMIT偏移量算错。解决确认前端传的页码从 1 开始后端new Page(pageNum, pageSize)里pageNum不要减 1。MyBatis-Plus 内部会自动算偏移量不用手动干预。6. 进阶技巧用代码生成器反推表结构如果你拿到的源码没有 SQL 脚本或者你想基于现有实体类快速生成建表语句MyBatis-Plus 的代码生成器能帮上忙。它原本是用来从表生成 Java 代码的但反过来用也能根据实体类推断字段类型。更直接的办法是写一段反射代码扫描实体类的字段和注解拼出CREATE TABLE语句。// 根据实体类生成建表 SQL 的简化示例 public class SqlGenerator { public static String generate(Class? clazz) { StringBuilder sql new StringBuilder(CREATE TABLE ); TableName tableName clazz.getAnnotation(TableName.class); sql.append(tableName ! null ? tableName.value() : clazz.getSimpleName().toLowerCase()); sql.append( (\n); for (Field field : clazz.getDeclaredFields()) { sql.append( ).append(camelToUnderline(field.getName())).append( ); if (field.getType() String.class) { sql.append(VARCHAR(255)); } else if (field.getType() Long.class) { sql.append(BIGINT); } else if (field.getType() LocalDateTime.class) { sql.append(DATETIME); } TableId tableId field.getAnnotation(TableId.class); if (tableId ! null) { sql.append( PRIMARY KEY AUTO_INCREMENT); } sql.append(,\n); } sql.setLength(sql.length() - 2); // 去掉最后一个逗号 sql.append(\n) ENGINEInnoDB DEFAULT CHARSETutf8mb4;); return sql.toString(); } private static String camelToUnderline(String name) { return name.replaceAll(([a-z])([A-Z]), $1_$2).toLowerCase(); } }这段代码的核心逻辑是读TableName拿表名遍历字段根据 Java 类型映射到 SQL 类型遇到TableId就加主键约束。camelToUnderline把驼峰命名转成下划线比如createTime变成create_time。实际用的时候String类型最好根据业务设长度别一律 255Integer和int要映射成INTBigDecimal映射成DECIMAL。这个脚本跑一遍把输出的 SQL 贴到 MySQL 里执行表就建好了。我一般还会在生成后手动检查两件事一是字段长度够不够比如地址字段 200 可能不够得改 500二是索引如果name或phone经常用来搜索加个普通索引能明显提升查询速度。这些细节代码生成器不会帮你判断得靠自己对业务的理解。从那以后我每次拿到没有 SQL 脚本的 Java 管理系统源码都会先跑一遍这个生成逻辑再对照实体类逐个核对字段类型和长度确认无误才导入数据库。希望帮到你。本文还有配套的精品资源点击获取 Java个人信息维护系统源码解析：从跑通到二次开发实战
简介这是一份面向Java初学者与课程设计学生的个人信息维护系统完整项目源码以Java后端开发为核心结合网页设计与数据库操作帮助读者掌握从登录验证到信息管理的完整Web应用开发流程。压缩包共78个文件约1.24MB包含8个Java源文件、42个XML配置、5个CSS与5个JS前端资源以及2个SQL建表脚本、properties配置、html页面和课程设计报告文档覆盖后端逻辑、前端样式与数据库脚本各环节。系统涵盖用户登录、个人信息展示与修改、登录历史表格显示等模块涉及JDBC连接、SQL增删改查、MVC分层设计及密码加密等知识点适合作为课程设计或自学练手项目。目前已有100人学习下载读者可据此理解项目结构、数据库表设计与前后端交互思路并在此基础上扩展异常处理与安全性优化。1. 从一份 Java 个人信息维护系统源码说起它到底能跑通什么很多人拿到「基于 Java 设计的个人信息维护系统.zip」这类资源第一反应是解压、找 main 方法、点运行然后卡在数据库连不上或者页面 404。我拆过不少同类型的管理系统源码这类项目的定位其实很清晰它是一个典型的 Java Web 单体应用核心业务围绕「人」的信息做增删改查附带登录鉴权、分页列表、条件检索这些管理后台的标配能力。它解决的不是高并发场景而是让你有一套结构完整、能二次开发的 CRUD 骨架。适合谁用如果你正在学 Java Web 的完整链路想找一个能跑通「浏览器请求 → Controller → Service → DAO → 数据库 → 页面渲染」全流程的练手项目这份源码的价值就在这里。它比你自己从零搭一个 Spring Boot 空壳要省事因为表结构、实体类、前端页面都给你了。但如果你指望它直接上线扛生产流量那得先看清楚它的技术栈和分层设计再决定。下面我按「先搞懂结构、再动手跑通、最后避开坑」的顺序把这份资源拆开讲。2. 拆解项目结构与技术栈先搞清楚它靠什么跑起来2.1 典型分层与依赖关系这类个人信息维护系统常见做法是 Spring Boot MyBatis或 MyBatis-Plus MySQL Thymeleaf/JSP 的组合。为什么这么选因为 Spring Boot 省去了大量 XML 配置MyBatis 对 SQL 的控制力比 JPA 更直接适合管理系统里那些带多条件筛选的查询。前端如果用 Thymeleaf页面和 Java 代码耦合度低改起来不用重新编译整个前端工程。拿到源码后先别急着导入 IDE。我一般会先看三个地方pom.xml里的依赖版本、application.yml或.properties里的数据源配置、以及src/main/resources下有没有 SQL 初始化脚本。这三样决定了你能不能顺利跑起来。# 先看项目根目录结构确认构建方式 ls -la # 如果是 Maven 项目会有 pom.xmlGradle 项目则是 build.gradle # 再看资源目录里有没有建表语句 find . -name *.sql -o -name schema.sql -o -name data.sql上面这几条命令的作用是快速定位项目的构建工具和数据库初始化方式。pom.xml存在说明是 Maven 项目后续用mvn命令操作*.sql文件如果存在说明作者已经把建表语句准备好了你只需要在 MySQL 里执行一遍。如果没找到 SQL 文件那就得根据实体类反推表结构这一步后面会讲。2.2 实体类与表结构的对应关系管理系统类项目的实体类通常放在entity或domain包下字段和数据库列一一对应。常见做法是用 MyBatis-Plus 的注解来映射比如TableName、TableId、TableField。如果你拿到的项目没有 SQL 脚本可以根据实体类手动建表或者用 MyBatis-Plus 的代码生成器反向生成。// 典型的用户信息实体类结构 Data TableName(user_info) public class UserInfo { TableId(type IdType.AUTO) private Long id; // 主键自增 private String name; // 姓名 private String phone; // 手机号 private String email; // 邮箱 private String address; // 地址 TableField(fill FieldFill.INSERT) private LocalDateTime createTime; // 创建时间自动填充 }这段代码里TableName指定了对应的数据库表名TableId的IdType.AUTO表示主键由数据库自增生成。TableField(fill FieldFill.INSERT)是 MyBatis-Plus 的自动填充功能插入时自动写入当前时间省去手动 set 的麻烦。如果你用的不是 MyBatis-Plus 而是原生 MyBatis那这些注解就不存在需要靠 XML 映射文件或注解 SQL 来维护字段关系。参数说明IdType.AUTO适合 MySQL 的自增主键如果用的是 Oracle 序列或 UUID要改成对应的策略。FieldFill.INSERT只在插入时生效更新时想自动填充得用FieldFill.INSERT_UPDATE。2.3 配置文件里的关键参数application.yml是跑通项目的命门。数据库连接、端口、日志级别都在这里。我见过太多人因为没改数据源配置启动直接报Communications link failure。server: port: 8080 # 服务端口被占用就改成 8081 或别的 spring: datasource: url: jdbc:mysql://localhost:3306/personal_info?useSSLfalseserverTimezoneAsia/Shanghai username: root # 改成你本地 MySQL 的用户名 password: your_password # 改成你本地 MySQL 的密码 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发阶段关掉缓存改页面不用重启 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印 SQL方便调试url里的serverTimezoneAsia/Shanghai是必须的否则 MySQL 8.x 会报时区错误。useSSLfalse在本地开发时关掉 SSL 省事生产环境要开。log-impl配成StdOutImpl后每次查询都会在控制台打印实际执行的 SQL调条件筛选的时候特别有用。thymeleaf.cachefalse只在开发阶段设上线要改回true不然每次渲染都读磁盘性能会掉。3. 从零跑通系统环境准备与启动步骤3.1 环境版本对齐在动手之前先把版本对齐。这类项目对版本比较敏感JDK 8 和 JDK 17 跑起来可能完全不一样。常见做法是如果pom.xml里写的java.version是 1.8那就用 JDK 8如果是 17那就用 17。MySQL 建议用 5.7 或 8.0两者在驱动类名上有区别——5.7 用com.mysql.jdbc.Driver8.0 用com.mysql.cj.jdbc.Driver。组件推荐版本说明JDK8 或 17看 pom.xml 里的 source/targetMySQL5.7 / 8.08.0 需要配时区Maven3.6用于依赖下载和打包IDEIDEA / EclipseIDEA 对 Spring Boot 支持更好3.2 建库建表与数据初始化如果项目里有 SQL 脚本直接导入。没有的话根据实体类手写建表语句。下面是一个通用的用户信息表结构字段可以根据实体类增减。CREATE DATABASE IF NOT EXISTS personal_info DEFAULT CHARACTER SET utf8mb4; USE personal_info; CREATE TABLE user_info ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) COMMENT 手机号, email VARCHAR(100) COMMENT 邮箱, address VARCHAR(200) COMMENT 地址, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;utf8mb4而不是utf8是因为前者支持完整的 Unicode 字符包括 emoji。ENGINEInnoDB支持事务和外键管理系统里如果涉及多表操作InnoDB 是必须的。create_time给了默认值CURRENT_TIMESTAMP这样即使代码里没设数据库也会自动填。3.3 启动与验证配置改完后用 Maven 启动。如果是 Spring Boot 项目直接跑主类或者用命令。# 在项目根目录执行跳过测试加快启动 mvn spring-boot:run -DskipTests # 或者先打包再运行 mvn clean package -DskipTests java -jar target/*.jar启动成功后控制台会打印Started Application in x.x seconds。这时候打开浏览器访问http://localhost:8080应该能看到登录页或首页。如果 404检查 Controller 里的RequestMapping路径和 Thymeleaf 模板存放位置是否匹配。如果登录后报数据库错误回头看application.yml里的库名、用户名、密码是否和本地一致。提示第一次启动如果卡在下载依赖检查 Maven 的settings.xml是否配了国内镜像。依赖下载不全会导致编译失败报ClassNotFoundException。4. 二次开发与功能扩展改哪里、怎么改4.1 新增字段的完整链路管理系统最常见的二次开发就是加字段。比如要在用户信息里加一个「身份证号」需要改四个地方数据库表加列、实体类加属性、Mapper XML如果用原生 MyBatis加映射、前端页面加输入框。用 MyBatis-Plus 的话Mapper XML 可以省掉但实体类和页面必须改。// 实体类新增字段 private String idCard; // 身份证号 // Controller 里接收参数时如果是对象绑定不用改 // 如果是单独接收要加 RequestParam!-- Thymeleaf 页面新增输入框 -- div classform-group label身份证号/label input typetext th:field*{idCard} classform-control / /div实体类加字段后MyBatis-Plus 会自动把idCard映射成id_card驼峰转下划线前提是mybatis-plus.configuration.map-underscore-to-camel-case为true默认就是。页面里的th:field*{idCard}会自动绑定表单对象提交时 Spring MVC 自动封装。4.2 条件查询与分页的实现管理系统的列表页通常带搜索框和分页。MyBatis-Plus 提供了QueryWrapper和Page对象几行代码就能搞定。// Service 层分页查询示例 public IPageUserInfo searchUsers(int pageNum, int pageSize, String keyword) { PageUserInfo page new Page(pageNum, pageSize); QueryWrapperUserInfo wrapper new QueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(name, keyword) .or() .like(phone, keyword); } wrapper.orderByDesc(create_time); return userInfoMapper.selectPage(page, wrapper); }Page对象封装了当前页和每页条数selectPage返回的结果里包含总记录数和当前页数据。QueryWrapper的like方法生成LIKE %keyword%or()连接多个条件。注意orderByDesc(create_time)用的是数据库列名不是 Java 属性名。如果字段名和列名不一致这里要写列名。参数说明pageNum从 1 开始不是 0pageSize别设太大管理系统一般 10 到 20 条一页就够设成 1000 会把数据库拖慢。4.3 登录鉴权的常见实现这类项目通常有一个简单的登录拦截。常见做法是用 Session 存用户信息配合一个HandlerInterceptor做拦截。// 拦截器配置 Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/login, /css/**, /js/**); } }addPathPatterns(/**)拦截所有请求excludePathPatterns放行登录页和静态资源。LoginInterceptor里判断 Session 中是否有用户对象没有就重定向到登录页。这种方案简单直接但要注意静态资源路径别被拦了否则页面样式全丢。5. 避坑与排查那些让我重启了十几次的问题5.1 启动报数据库连接失败现象控制台抛Communications link failure或Access denied for user。原因application.yml里的用户名、密码、库名和本地 MySQL 不一致或者 MySQL 服务没启动。解决先用命令行mysql -u root -p确认能登录再核对配置文件。如果是 8.0 版本检查url里有没有serverTimezone。5.2 页面 404 或模板找不到现象浏览器访问返回 404或者报TemplateInputException。原因Thymeleaf 模板默认放在src/main/resources/templates下Controller 返回的视图名要和文件名对应。如果用了 JSP路径配置又不一样。解决检查Controller类里方法的返回值比如return user/list对应templates/user/list.html。文件扩展名和目录层级都要对上。5.3 中文乱码现象页面输入中文存到数据库变成问号或者页面显示乱码。原因数据库字符集不是utf8mb4或者连接 URL 没指定编码。解决建库时用DEFAULT CHARACTER SET utf8mb4连接 URL 加characterEncodingutf8。Thymeleaf 页面头部加meta charsetUTF-8。5.4 修改代码后不生效现象改了 Java 代码或页面重启后还是旧内容。原因Thymeleaf 缓存没关或者 IDE 没有自动编译。解决application.yml里设spring.thymeleaf.cachefalseIDEA 里开启Build project automatically。改 Java 代码必须重启改 HTML 可以刷新。5.5 分页查询返回空数据现象列表页有数据但翻到第二页就空了。原因Page对象的pageNum传了 0或者 SQL 里LIMIT偏移量算错。解决确认前端传的页码从 1 开始后端new Page(pageNum, pageSize)里pageNum不要减 1。MyBatis-Plus 内部会自动算偏移量不用手动干预。6. 进阶技巧用代码生成器反推表结构如果你拿到的源码没有 SQL 脚本或者你想基于现有实体类快速生成建表语句MyBatis-Plus 的代码生成器能帮上忙。它原本是用来从表生成 Java 代码的但反过来用也能根据实体类推断字段类型。更直接的办法是写一段反射代码扫描实体类的字段和注解拼出CREATE TABLE语句。// 根据实体类生成建表 SQL 的简化示例 public class SqlGenerator { public static String generate(Class? clazz) { StringBuilder sql new StringBuilder(CREATE TABLE ); TableName tableName clazz.getAnnotation(TableName.class); sql.append(tableName ! null ? tableName.value() : clazz.getSimpleName().toLowerCase()); sql.append( (\n); for (Field field : clazz.getDeclaredFields()) { sql.append( ).append(camelToUnderline(field.getName())).append( ); if (field.getType() String.class) { sql.append(VARCHAR(255)); } else if (field.getType() Long.class) { sql.append(BIGINT); } else if (field.getType() LocalDateTime.class) { sql.append(DATETIME); } TableId tableId field.getAnnotation(TableId.class); if (tableId ! null) { sql.append( PRIMARY KEY AUTO_INCREMENT); } sql.append(,\n); } sql.setLength(sql.length() - 2); // 去掉最后一个逗号 sql.append(\n) ENGINEInnoDB DEFAULT CHARSETutf8mb4;); return sql.toString(); } private static String camelToUnderline(String name) { return name.replaceAll(([a-z])([A-Z]), $1_$2).toLowerCase(); } }这段代码的核心逻辑是读TableName拿表名遍历字段根据 Java 类型映射到 SQL 类型遇到TableId就加主键约束。camelToUnderline把驼峰命名转成下划线比如createTime变成create_time。实际用的时候String类型最好根据业务设长度别一律 255Integer和int要映射成INTBigDecimal映射成DECIMAL。这个脚本跑一遍把输出的 SQL 贴到 MySQL 里执行表就建好了。我一般还会在生成后手动检查两件事一是字段长度够不够比如地址字段 200 可能不够得改 500二是索引如果name或phone经常用来搜索加个普通索引能明显提升查询速度。这些细节代码生成器不会帮你判断得靠自己对业务的理解。从那以后我每次拿到没有 SQL 脚本的 Java 管理系统源码都会先跑一遍这个生成逻辑再对照实体类逐个核对字段类型和长度确认无误才导入数据库。希望帮到你。本文还有配套的精品资源点击获取