企业官网建设流程全解析

做了几年Java后端，接过不少毕业设计相关的项目，像“基于SpringBoot宠物领养平台”这类题目，说实话属于非常典型的一类：业务逻辑不复杂、模块边界清晰、技术栈主流，既能体现工程能力，又不会因为体量过大导致周期失控。但越是这种“看起来不难”的项目，越容易在细节上翻车——表结构设计得不合理、登录状态没处理好、图片上传路径一部署就失效、答辩时被问到底层原理就卡壳。这篇文章我会以这个项目为主线，把从需求拆解、技术选型、数据库设计、核心功能实现到论文编排、答辩准备的完整链路拆开讲清楚，尤其是一些常规文档里不会写的坑和经验。适合正在做相关课题的在校学生，也适合想快速上手一个完整Web项目的开发者参考。

1. 项目整体设计思路与需求拆解

1.1 先搞清楚宠物领养平台到底在解决什么问题

很多人在动手写代码之前容易犯一个误区：上来就建工程、写实体类，结果写到一半发现逻辑混乱、改来改去。我自己的习惯是先把业务场景和核心问题梳理清楚。宠物领养平台本质上是一个连接“送养人”和“领养人”的信息中介系统，但同时因为涉及宠物的生命健康和安全责任，它的业务规则要比普通的二手交易平台更谨慎一些。

具体来说，核心问题可以拆成三个：

第一，信息发布与展示。送养人需要一个入口来发布宠物信息，包括宠物品种、年龄、性别、健康状况、照片、性格描述等。这些信息要能展示给潜在领养人。

第二，领养申请与审核。领养人看到合适的宠物后，需要提交申请，说明自己的养宠条件和动机。送养人或者管理员要对这些申请进行审核，决定是否同意领养。

第三，平台管理与数据维护。管理员需要管理用户、审核宠物信息、处理留言反馈，确保平台上发布的信息真实有效，领养流程规范。

对应这三个问题，系统的基本用户角色就是三种：管理员、送养用户、领养用户。实际开发时，很多同学会把送养人和领养人做成两张表或者两个角色权限来区分，但我的建议是合并成一张用户表，用字段或者后续业务逻辑去区分身份，这样可以避免账号体系冗余，也方便用户既送养又领养同一个账号完成操作。

1.2 功能模块划分与边界控制

明确了问题，接下来就是模块划分。一个合格的SpringBoot宠物领养平台，在功能上至少要包含下面这些模块，我按照后端管理的便利性和用户操作的链路顺序整理了一下：

• 用户模块：注册、登录、个人信息查看与编辑、头像上传、密码修改。
• 宠物管理模块：宠物信息的发布、编辑、下架、删除，宠物状态流转（待审核、待领养、已领养）。
• 领养申请模块：提交领养申请、查看申请进度、审核申请、记录领养结果。
• 收藏与留言模块：用户收藏感兴趣的宠物，对宠物信息进行留言咨询。
• 公告与留言板模块：平台通知公告发布、用户留言互动。
• 后台管理模块：管理员登录后可管理用户状态、审核宠物信息、管理公告。

这里需要特别强调一下“边界控制”。举个例子，一个普通登录用户能不能修改别人的宠物信息？当然不能。那“送养人”在自己发布宠物信息后，是否可以自行将宠物状态改为已领养？我认为合理的做法是，用户只能申请将宠物下架或者标记为自己已线下完成领养，但正式的“领养完成”状态标记，应该由管理员在审核领养申请通过后统一变更。这样既保留了送养人的自主权，又保证了数据变更的可追溯性。

1.3 数据库表结构设计：一张好表能省一半的麻烦

数据库是整个项目的基石，表结构设计好了，后面的CRUD代码写起来会非常顺手。我先给出核心表的设计方案，再解释几个关键字段的用意。

用户表 user

宠物表 pet

领养申请表 adopt_apply

收藏表 favorite、留言表 message、公告表 notice结构相对简单，基本是“主键 + 关联id + 内容 + 时间”的标配，这里不展开。

有几个容易踩的坑提醒一下：一是age字段不要用int存“月数”，因为宠物年龄描述可能是“1岁2个月”，用varchar反而更灵活；二是images字段用逗号分隔存储多张图片路径，虽然不符合严格的数据库范式，但在这种体量的项目中非常实用，读取时先split再拼接完整访问路径即可，不用额外建一张图片表；三是全表建议统一使用datetime，避免日期格式化时出现时区问题。

2. 核心技术选型与方案取舍解析

2.1 为什么主线框架选SpringBoot而不是SSH或SpringMVC

这个问题基本不用犹豫。SpringBoot带来的最大好处就是“约定大于配置”，内嵌Tomcat，打一个jar包就能直接跑起来，极大地降低了环境搭建和部署的复杂度。对于毕业设计或者课程设计这种需要快速出成果、又要保证稳定性的场景，SpringBoot 2.7.x是首选。

当然，有两个细节要特别注意。一是JDK版本和SpringBoot版本的对应关系。我个人建议使用JDK 1.8 + SpringBoot 2.7.x的组合，虽然SpringBoot 3.x已经发布了，但它要求JDK 17及以上，并且javax包名变成jakarta，很多老教程和老代码会踩坑。对于以稳为主的毕设项目，2.7.x足够用了。二是如果答辩时有老师问到“为什么用SpringBoot”，一定要答出它对SpringMVC、自动装配、起步依赖这些底层机制的整合，而不是只说“因为它好用”，这样就显得深度不够。

2.2 持久层选型：MyBatis Plus vs Spring Data JPA

持久层是我被问得最多的问题之一。很多同学会纠结到底用JPA还是MyBatis，其实在这个项目里，我更推荐MyBatis Plus。

原因有几点：首先，MyBatis Plus提供的BaseMapper内置了selectById、selectList、insert、updateById这些常用方法，单表CRUD几乎不用写SQL；其次，它的QueryWrapper和LambdaQueryWrapper可以非常灵活地构造条件查询，对于宠物筛选、搜索这类的动态SQL场景非常友好；第三，Unity毕业设计项目的代码可读性很重要，MyBatis Plus的Mapper接口加XML的方式，老师们普遍比较认可。

我举个实际的例子，用户按品种和性别筛选宠物，传统MyBatis需要自己写动态SQL标签拼条件，而MyBatis Plus只需要这样：

LambdaQueryWrapper<Pet> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(StringUtils.hasText(type), Pet::getType, type) .eq(StringUtils.hasText(breed), Pet::getBreed, breed) .eq(StringUtils.hasText(gender), Pet::getGender, gender) .eq(Pet::getStatus, 1); List<Pet> pets = petMapper.selectList(wrapper);

每行即一个条件，自动拼接、自动过滤空值，代码简洁且不会出错。这一点在后期要加搜索条件时能明显体会到效率优势。

2.3 前端方案选择：模板引擎还是前后端分离

对于宠物领养平台这个体量的项目，我不太建议一上来就搞Vue + SpringBoot的完全前后端分离，理由很现实：工作量会翻倍，你要处理跨域、Token鉴权、前端构建打包这些问题，而在演示和答辩环节，这些反而容易成为被追问的薄弱点。

我更推荐用Thymeleaf作为服务端模板引擎，配合Bootstrap和少量原生JavaScript、Ajax。Thymeleaf的优势在于它和SpringBoot无缝集成，数据由后端渲染到页面上，不需要额外搭建前端工程。页面上如果需要局部刷新，比如前台搜索筛选、领养申请对话框提交，集成jQuery + Ajax就能优雅解决，接口返回JSON即可。

这种方案一是整体代码量比前后端分离少得多，二是非常适合单人完成，三是答辩时老师可以沿着页面点击，直接在后端代码和模板文件里讲清楚数据流，逻辑非常直观。当然，如果你的题目明确要求前后端分离，那就另当别论，项目体量会大不少。

2.4 登录鉴权方案：Session还是JWT

关于登录状态管理，很多同学会在Session和JWT之间摇摆。我的建议是，对于基于Thymeleaf的服务端渲染项目，直接用Session即可，简单可靠，且不需要引入额外依赖。

具体的实现思路是：用户登录成功后，将用户ID和账户名存入Session，并编写一个HandlerInterceptor拦截器，对需要登录的路径（如发布宠物、提交领养申请、后台管理）进行拦截，检查Session中是否存在用户信息，若不存在则跳转到登录页并给出提示。管理员和普通用户的权限区分，同样可以在拦截器中判断Session中的role字段。

有些同学可能会问，JWT不是更现代吗？注意，JWT适合无状态的前后端分离架构，一旦前端是服务端渲染的模板页，使用Cookie + Session就是最自然的方案。这里补充一个Session使用中的配置细节：在application.yml中通过server.servlet.session.timeout配置Session的过期时间，一般是30分钟或1小时，避免用户长时间挂着页面导致会话过期却不知道。

3. 实操过程与核心环节实现细节

3.1 开发环境与工程骨架搭建

先列出我的环境配置版本，这套组合经过反复验证，兼容性没有问题：

• JDK 1.8
• SpringBoot 2.7.14
• MySQL 5.7或8.0均可
• Maven 3.8+
• 开发工具：IDEA
• 前端资源：Bootstrap 4.6、jQuery 3.6、Thymeleaf

创建工程时，我建议直接访问Spring Initializr站点生成基础工程，并选择Web、Thymeleaf、MyBatis、MySQL、Lombok这几个依赖，后期再手动引入MyBatis Plus的依赖。

核心的pom.xml依赖片段如下：

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.2</version> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-generator</artifactId> <version>3.5.3</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId> <version>2.7.14</version> </dependency>

注意，引入spring-boot-starter-security时，SpringSecurity会默认对所有请求做权限校验，很多人第一步就在这里懵了，怎么访问首页都跳出一个登录框。解决方案是在配置类中放行所有请求，只使用BCryptPasswordEncoder做密码加密，教程里很多写法是专门配置一个SecurityConfig实现WebSecurityConfigurerAdapter，重写configure方法放行所有接口。

3.2 application.yml配置文件的关键项

我也直接把一份可用的application.yml核心配置放出来，并解释几个容易出错的地方：

server: port: 8080 servlet: session: timeout: 60m spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/pet_adopt?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 thymeleaf: cache: false encoding: UTF-8 servlet: multipart: max-file-size: 10MB max-request-size: 10MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0

三个容易踩坑的细节：

一是数据库URL中一定要带上serverTimezone=Asia/Shanghai，否则高版本MySQL驱动连接时会因为时区问题报错。

二是thymeleaf.cache=false一定要设置，否则改了模板页面后刷新浏览器看不到变化，每次都要重启项目，非常影响开发效率。

三是multipart的max-file-size要结合实际图片大小调整，宠物图片一般可能拍到两三MB，默认1MB很容易上传失败。但也要设置合理上限，避免有人故意传大文件。

3.3 实体类与统一返回结构设计

实体类直接对应数据库表结构，我习惯用Lombok注解简化代码。以宠物实体为例做示范：

@Data @TableName("pet") public class Pet { @TableId(type = IdType.AUTO) private Long id; private String name; private String type; private String breed; private String age; private String gender; private String healthInfo; private String description; private String images; private Integer status; private Long publisherId; private LocalDateTime createTime; }

除了实体类，还需要设计一个统一的Ajax返回结果类，我通常命名为Result。它包含code、message、data三个字段，成功时code为200，失败时code为500。这样前后端交互的数据格式统一，前端JavaScript里只需要判断code === 200即可进入正常流程，代码非常干净。

3.4 用户注册登录模块与密码加密

用户注册的核心逻辑不复杂，但有两点必须做好。一是用户名重复性校验，在插入前先按username查库，如果已存在就返回“用户名已被注册”。二是密码加密，绝对不允许明文存入数据库。这里用SpringSecurity提供的BCryptPasswordEncoder，注册时加密存储，登录时使用matches方法校验。

登录成功后，我还会把用户的基本信息填充到Model中，供Thymeleaf模板渲染。例如在个人信息页面显示当前登录用户的昵称和头像，我习惯写一个BaseController，所有需要登录用户信息的Controller继承它，通过一个getLoginUser()方法从Session中取出用户对象，避免每个Controller都重复写同样的Session取值代码。

3.5 宠物发布与图片上传

宠物发布是整个平台最核心的操作之一。前端页面需要用户填写宠物的基本信息，选择一张或多张宠物照片，点击提交后后端接收数据并保存。

图片上传的处理逻辑我重点说明一下。我是把图片保存到本地的upload目录下，然后通过WebMvcConfigurer配置一个虚拟路径映射，将/upload/**映射到磁盘上的绝对路径，这样在页面里就能直接通过/upload/xxx.jpg访问图片。

配置代码大致是这样的：

@Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String path = System.getProperty("user.dir") + "/upload/"; registry.addResourceHandler("/upload/**") .addResourceLocations("file:" + path); }

这里有个非常重要的部署细节：System.getProperty("user.dir")获取的是项目运行时的当前工作目录。在IDEA中运行项目时，它是项目根目录；打成jar包用java -jar运行时，它取决于jar包所在的目录。因此为了让开发环境和部署环境行为一致，我通常会配置一个自定义属性来设定上传目录，比如在application.yml里定义file.upload-path，然后读取配置获取绝对路径，避免用户目录不同带来的路径错乱。

发布成功后，pet.status默认设置为0（待审核），这意味着普通用户在前台列表页是看不到这条信息的，只有管理后台审核通过后才会展示出来。这个流程保证了平台信息的可信度，也是答辩时一个可以展示的“商业逻辑亮点”。

3.6 领养申请与状态流转实现

领养申请模块涉及到多表操作和状态联动，很能体现程序员对业务细节的把控能力。用户点击“申请领养”按钮后，后端会执行以下逻辑：先校验当前用户是否已登录，未登录则返回跳转登录页；然后检查宠物状态是否为“待领养”，如果不是则提示不能申请；再查看当前用户是否已经申请过该宠物，避免重复申请；全部通过后插入一条领养申请记录。

审批通过后，需要做两件联动操作：一是将adopt_apply表里该宠物其他所有待审核的申请统一置为“已拒绝”，原因是宠物已经有归属了，其他申请没有继续存在的意义；二是将pet表里对应宠物的status改为2即已领养，同时记录领养完成时间。这两步操作必须放在一个事务中执行，否则一旦第二步失败，就会出现“申请已通过但宠物还是待领养状态”的脏数据。

这个事务逻辑看起来简单，但实际操作中很多同学的代码是写完一个update就完事，不考虑联动状态。建议在答辩时能主动提到这一点，属于很好的加分项，它体现的不只是CRUD能力，还有对数据一致性的理解。

3.7 列表分页与筛选功能

前台宠物列表页是用户访问最频繁的页面，设计上需要同时支持分页和筛选。分页可以直接使用MyBatis Plus内置的PaginationInnerInterceptor，只需配置一个MybatisPlusConfig配置类，注入MybatisPlusInterceptor并添加分页插件即可。

筛选条件则根据前端页面传入的参数动态拼接，前面已经展示过LambdaQueryWrapper的用法。需要注意的一点是，前端筛选项和宠物status条件要组合使用，用户只能看到status为1（待领养）的宠物，这个过滤条件是强制的，不能只依赖前端隐藏，必须在后端接口中固定拼接，防止有人绕过页面逻辑直接调用接口查看到未审核的宠物信息。

4. 常见问题排查与避坑经验实录

4.1 数据库连接相关的报错

项目跑起来后第一道坎通常是连不上数据库。最常见的报错是Access denied for user，一看就是用户名或密码不对，这个好解决。还有一种报错是Public Key Retrieval is not allowed，这个在MySQL 8.0版本连接时会出现，需要在数据库URL后面加上allowPublicKeyRetrieval=true参数。如果出现时钟偏差过大导致认证失败，就加上useSSL=false，这些参数虽然不起眼，但没有它们数据库连接就是起不来。

还有一类情况是建库时字符集没选对，导致插入中文数据变成乱码。我建议在创建数据库时直接执行建库语句：

CREATE DATABASE pet_adopt DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

utf8mb4比utf8多支持了表情符号和其他特殊字符，安全性更好。不要使用默认字符集去建库，否则后面改字符集非常麻烦。

4.2 页面能打开但CSS样式加载不出来

这种现象在Thymeleaf项目中很常见，尤其是有时候页面能打开但整个页面光秃秃的，一点样式都没有。绝大多数原因是你写了${pageContext.request.contextPath}这种JSP时代的表达式，而Thymeleaf模板里根本不认识它。正确做法是用Thymeleaf的语法，引入css和js时使用th:href="@{/css/style.css}"，加上th前缀的URL表达式。

另外一个容易被忽略的问题是资源文件的目录位置。SpringBoot的静态资源默认从classpath:/static/下读取，如果你把css、js、图片放到了templates目录下，那肯定加载不出来。正确做法是：templates目录放Thymeleaf模板页面，static目录放css、js、图片等静态资源。

4.3 图片上传成功但页面显示404

这个坑出现的频率非常高，尤其在本地IDEA里测试好好的，打jar包部署后就404。原因就是我前面提到的工作目录变化导致虚拟路径映射失效。解决思路有两种，一是直接把上传目录写死为一个固定路径，比如放在D:/pet_upload/，但这不灵活；二是利用配置项，自定义一个file.upload-path配置，然后在配置类中用@Value注解读取它，这样开发和生产环境都能通过修改配置文件来调整目录，最推荐这种做法。

同时还要注意，页面显示图片时拼的路径是/upload/xxx.jpg，这个访问路径和存取磁盘的真实文件名最好保持一致。我处理图片存储时会让文件命名统一为时间戳加随机数加原始后缀，例如20230815153012_2934.jpg，这样既不会重名，也不需要额外处理文件名编码问题。

4.4 拦截器放行路径设置不全导致页面资源被拦截

登录拦截器写好后，很多人会遇到一种尴尬情况：访问登录页可以放行，但登录页的CSS和JS也被拦截了，页面样式全丢。根本原因是拦截器配置的放行路径没有包含/static/, /css/, /js/**, /images/**等静态资源路径。

实战中我推荐一个稳妥做法：自定义拦截器时，addPathPatterns设置为/**，同时excludePathPatterns里依次列举需要放行的路径，包括登录页、注册页、静态资源目录、上传文件访问路径等。这样一旦页面资源加载异常，排查思路第一件事就是看拦截器放行列表是否完整。

4.5 事务注解不生效的隐蔽问题

@Transactional在SpringBoot项目中默认对RuntimeException回滚，但如果你的代码中catch了异常并打印了日志而没有主动抛出，事务是不会回滚的。这是一个非常隐蔽的事务失效场景。

举个例子，在审批领养申请时，我做两步更新：第一步置其他申请为拒绝，第二步更新宠物状态。如果第二步抛出SQL异常，但第一步外面有try-catch把异常吞掉了，那么第一步的数据变更会正常提交，第二步没执行，数据库里就出现了逻辑矛盾。

正确的写法是让事务方法对外抛出异常，在Controller层统一捕获处理并返回错误信息。理解了这一条，你的事务代码才算真正可靠。

5. 论文结构与答辩PPT编排的实战经验

5.1 论文框架怎么搭既省力又有条理

很多同学的论文写得像用户手册，流水账式地罗列功能，老师印象自然不会好。我的经验是，论文的结构应该呈现“发现问题—设计思路—技术实现—验证方案”的逻辑链。

一般可以用这个框架：第一章绪论，写背景、意义和国内外现状，重点讲清楚“为什么做宠物领养平台”，可以结合线下领养信息不对称的痛点来写；第二章相关技术介绍，把SpringBoot、MyBatis Plus、Thymeleaf、MySQL这几个技术讲清楚，不用写太深，讲清楚用途和优势即可；第三章需求分析，画用例图，把管理员、普通用户各自能干什么明确写出来；第四章系统设计，包含总体架构设计、功能模块划分、数据库E-R图与表结构；第五章系统实现，按用户模块、宠物模块、领养模块、管理模块的顺序，贴核心代码并配界面截图；第六章系统测试，写测试环境、测试用例、测试结果；最后是总结与展望。

论文中插入的代码，建议优先选择带业务代表性的，比如领养审核的事务方法、图片上传及虚拟路径映射、动态条件查询，这些代码配上一段文字解释，能明显提升论文的质量感。

需要特别提醒的是，表结构字段说明在论文中用表格形式展示，比贴实体类代码更直观，也更容易获得老师认可。每一张表的字段名、类型、说明一一列出，信息量清楚明了。

5.2 答辩PPT不需要太多页，重点突出四件事

答辩PPT页数控制在15页以内即可，太多反而讲不完。我习惯分成四块：

第一块讲背景与功能。用一页讲清楚“平台为谁解决什么问题”，再列功能架构图，说明系统有哪几个角色和模块。

第二块讲系统架构与数据库设计。画一张简单的分层架构图，展示Controller、Service、Mapper之间的关系，再放核心表结构以及表之间的关联关系。

第三块现场演示核心流程。这是最重要的一环，演示时不要从头到尾把所有功能都点一遍，太浪费时间。只挑两个核心链路走通它：一是注册登录到发布宠物再到管理员审核通过；二是用户申请领养到管理员审批通过。这两条主链路足以覆盖系统所有核心功能。

第四块讲亮点与不足。亮点可以是设计上的细节，比如领养申请事务一致性、图片上传的虚拟路径映射、多条件筛选的后端实现；不足也可以适当提几句，后期可以考虑引入消息推送通知申请结果、接入在线聊天等，这既显示你对自己的项目有清晰的认知，也为将来可能的扩展留下话题。

5.3 评委老师最爱追问的几个技术问题

根据以往经验，答辩时老师通常会抓住几个高频考点提问，提前准备一下可以大幅度降低现场卡壳的概率。

第一个问题是“SpringBoot自动装配的原理是什么”。对这个问题，最核心的回答是：SpringBoot的启动类上有一个@SpringBootApplication注解，它组合了@Configuration、@EnableAutoConfiguration和@ComponentScan；自动装配的核心是@EnableAutoConfiguration，它会通过导入AutoConfigurationImportSelector，读取META-INF/spring.factories中配置的自动配置类，而是否生效则由@ConditionalOnClass等条件注解控制。

第二个问题是“为什么用MyBatis Plus”。可以这样回应：MyBatis Plus在继承MyBatis的SQL控制能力的同时，内置了通用BaseMapper，能够直接将实体类字段映射为数据库列，大大减少单表增删改查的重复代码；同时它在分页、条件构造、逻辑删除等方面都提供了开箱即用的支持，非常适合中小型业务系统快速开发。

第三个问题是“Cookie和Session的区别，以及Session的工作原理”。要能答出：Cookie在客户端存储数据，Session在服务端存储用户数据；客户端每次请求会通过Cookie携带SessionId，服务端通过SessionId找到对应的Session对象；这个项目选择Session方案与Thymeleaf服务端渲染模式契合、实现简单、安全性可控。

第四个问题是“项目的安全性是如何考虑的”。可以从密码BCrypt加密、登录拦截器避免未授权访问、管理员和普通用户角色权限分离、宠物信息发布后需要后台审核这几个层面来回答，每个点都可以展开一两句说明具体实现思路。

我个人在实际操作中的体会是，宠物领养平台这类项目真正的难度从来不在技术本身，而是你能不能把“信息发布、申请审核、状态流转”这条业务主链想清楚，并且用合适的技术把链路跑通。你在设计表结构时每一个status字段、每一处事务边界、每一条拦截规则，背后都对应一个真实场景下的业务约束。把这些约束理解透了，代码自然写顺了，论文和答辩也就有了扎实的素材。

最后再分享一个小技巧：做完代码之后，一定要从零开始重新跑一遍完整流程，用一个新的数据库、新的文件目录，按照部署文档一步步操作。这个过程能逼你把项目里所有依赖外部环境和本地配置的地方全部暴露出来，对你自己的提升比多写几个功能模块都大。