写这篇文档之前先说明一下背景。我手上这个项目是基于SpringBoot的汽车资讯网站系统面向的用户场景很清晰普通访客浏览汽车资讯、查看车型库、阅读评测注册用户能评论、收藏后台管理员负责发布内容、管理用户。做它的初衷是有一个可以直接跑起来、能拿来教学也能当毕业设计和课程设计底子的完整项目——有源码、有文档、有部署说明、有代码讲解。今天把这些东西整理出来从项目设计思路、核心模块实现、数据库设计到部署上线和踩坑记录一次性聊透。1. 项目整体设计与技术选型思路1.1 为什么选SpringBoot而不是SSH或者SpringMVC很多刚开始做这类网站的同学会问为什么教程里都在推SpringBoot老项目里却常见SpringMVC甚至SSHSpringStrutsHibernate。我的回答很简单SpringBoot把Spring生态里那些繁琐的XML配置全部干掉用自动配置加约定优于配置的思维让你把注意力放在业务逻辑上而不是花两周时间调配置文件和版本依赖。具体到汽车资讯网站这个场景系统规模不大但涉及的功能点多——前台展示、用户注册登录、评论收藏、后台管理、文件上传、数据统计。如果用传统的SSH去搭光Spring、Struts、Hibernate三套框架的整合就能劝退大部分初学者。SpringBoot用Maven引入依赖一个内含Tomcat的jar包就能跑起来部署时不用装外部容器这对课程设计和毕设来说尤其友好。这个项目我最终选型的组合是SpringBoot 2.x具体用的是2.5.4MyBatis Plus数据持久层MySQL 5.7数据库Thymeleaf服务端模板引擎后台管理页面用它Bootstrap Layui前端UI框架Maven项目管理没用前后端分离原因在后面细说。1.2 单体应用还是前后端分离这是做这个项目时我反复纠结的一个点。现在主流方向是前后端分离Vue加SpringBoot接口文档一挂前端后端各干各的。但最终这个项目我选择了服务端渲染的单体应用理由有三个第一汽车资讯网站的内容形态以页面展示为主资讯详情、车型库、列表页这些场景对SEO有要求。服务端渲染直接输出HTML搜索引擎的爬虫抓取不到异步渲染的内容百度收录会非常吃亏。第二单体应用部署简单一个jar包扔到服务器上就完事不涉及Node环境、跨域配置、网关转发这些额外环节。第三对于以学习为主要目标的使用者来说单体架构的调试链路短写完一个功能刷新页面就能看到效果前后端联调的挫败感少很多。如果你后续想改成前后端分离核心的REST接口已经按JSON格式封装好了只需要把Controller的返回值改成ResponseBody前端用Vue或者React重写页面即可这个迁移路径是预留的。1.3 功能模块拆解与整体架构站在用户视角和站在管理员视角这个网站完全是两套体验。面向普通访客的是前台门户面向运营人员的是后台管理系统。我按照这两个视角把系统拆成了六个核心模块模块功能说明用户模块注册、登录、个人信息修改、头像上传资讯模块资讯列表分页浏览、按分类筛选、资讯详情车型模块品牌列表、车系列表、车型详情评论模块登录用户发表评论、评论列表展示收藏模块用户收藏资讯/车型、我的收藏列表后台管理资讯发布与编辑、分类管理、用户管理、数据统计看板架构上分三层Controller层负责接收请求、参数校验和返回结果Service层承载业务逻辑比如评论量加一、收藏状态判断、密码加密校验Mapper层通过MyBatis Plus跟数据库打交道。三层之间用接口隔离Service实现类通过Spring的IOC注入到Controller层避免到处new对象。2. 核心模块实现与关键代码解析2.1 用户注册登录安全细节不能省用户模块是所有业务的基础但也是很多课程设计做得最马虎的地方。我见过不少项目密码用明文存数据库登录用简单的等于判断这在实际项目中是要被狠狠吐槽的。这里我采用了MD5加盐的方式处理密码虽然MD5现在不再推荐用于高安全场景但对于课题型的项目已经够用而且便于演示讲解。注册的逻辑比较简单前端提交username、password、phone等字段后端先检查用户名是否重复再对密码做处理public boolean register(User user) { // 检查用户名是否被占用 LambdaQueryWrapperUser wrapper new LambdaQueryWrapper(); wrapper.eq(User::getUsername, user.getUsername()); if (userMapper.selectCount(wrapper) 0) { return false; } // 密码加盐处理 String salt UUID.randomUUID().toString().replace(-, ).substring(0, 4); String encryptedPwd MD5Util.md5(user.getPassword() salt); user.setPassword(encryptedPwd); user.setSalt(salt); user.setCreateTime(new Date()); return userMapper.insert(user) 0; }这里要注意数据库里password和salt字段分开存登录时取出该用户的盐把输入的密码拼上盐再MD5和库里的密文比对。加盐的意义在于即使两个用户设置了相同的密码密文也不同能有效防彩虹表碰撞。登录状态我用的是Session结合拦截器管理。项目里写了一个LoginInterceptor继承HandlerInterceptor接口在preHandle方法里判断当前Session有没有user对象没有就打回登录页。拦截器配置在WebMvcConfigurer里要特别注意排除掉登录接口、注册接口、静态资源和首页资讯列表这些不需要登录就能访问的路径否则会出现死循环跳转。2.2 资讯模块列表分页与分类筛选资讯是网站的核心内容列表页的体验直接影响用户留存。我用MyBatis Plus的Page对象配合分页插件实现列表查询代码很简洁public PageArticle getArticlePage(int pageNum, int pageSize, Long categoryId) { PageArticle page new Page(pageNum, pageSize); LambdaQueryWrapperArticle wrapper new LambdaQueryWrapper(); // 只查询已发布的资讯 wrapper.eq(Article::getStatus, 1); if (categoryId ! null) { wrapper.eq(Article::getCategoryId, categoryId); } wrapper.orderByDesc(Article::getPublishTime); return articleMapper.selectPage(page, wrapper); }分页插件的配置别忘了在MybatisPlusConfig里加我在初版代码里漏掉过这一步结果分页查询返回的永远是全部数据。配置方法很简单Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }资讯详情页除了展示正文还涉及两个联动操作阅读量加一和关联推荐。阅读量不能每次刷新都真实写库那样压力太大我采用了先更新内存计数、定期刷盘的思路虽然是简单项目但这个习惯可以保留。关联推荐的做法是查同分类下发布时间最近的几条排除当前文章用limit限定条数。2.3 评论模块自关联表设计评论功能看起来简单实际上有个细节容易踩坑回复某个人的评论怎么定位到被回复的那条。我的做法是评论表里除了article_id外加一个parent_id字段如果parent_id为0说明这是一条针对文章的顶层评论如果不为0则是某条评论的回复。前端展示时通过这个字段把回复嵌套在对应评论下面。查某个文章的评论列表一次查出所有评论在内存中按照parent_id组装成树形结构。对数据量不大的场景这种方式比递归SQL效率高得多代码也容易理解。查询逻辑大体是这样的public ListCommentVO getCommentsByArticleId(Long articleId) { LambdaQueryWrapperComment wrapper new LambdaQueryWrapper(); wrapper.eq(Comment::getArticleId, articleId) .eq(Comment::getStatus, 1) .orderByAsc(Comment::getCreateTime); ListComment allComments commentMapper.selectList(wrapper); // 组装树形结构parentId为0的作为根节点 return buildCommentTree(allComments); }发表评论的接口必须校验登录状态这里我通过Session里保存的用户ID去组装Comment对象而不是信任前端传过来的userId。很多接口安全问题都是因为后端盲信前端参数导致的这一点做项目时一定要养成习惯。2.4 车型库模块品牌到车系的级联展示车型库的页面结构参考了主流汽车网站的做法首页展示品牌字母索引点击某个品牌进去是车系列表再点车系看具体车型参数。数据库方面我建了三张表car_brand品牌、car_series车系、car_model具体车型通过brand_id和series_id关联。品牌索引页的字母分组是纯前端逻辑后端只需要把品牌列表查出来前端按品牌首字母的拼音在内存中排序分组即可。车系列表需要关联查询查出品牌下所有车系并且在每个车系后带上该车系的车型数量方便前端展示。一个实用的技巧是车型详情页的参数配置我用了一张parameter表来存用JSON字符串存储参数项的键值对。这种设计适合参数项不固定的场景如果汽车资讯网站未来要扩展新能源车型的电池参数、续航里程等新字段不用改表结构只改JSON内容就行。3. 数据库设计与核心表结构3.1 表结构总览与设计思路这个系统的数据库我一共设计了8张表表清单如下表名说明user用户表article资讯文章表article_category资讯分类表comment评论表car_brand汽车品牌表car_series车系表car_model车型表user_collect用户收藏表我的设计原则是能不加关联就不加关联能用逻辑删除就不用物理删除。比如收藏表并没有设计复杂的外键约束而是通过业务代码保证数据一致性。这样做的好处是查询时不需要数据库层做额外的join校验性能更好坏处是需要开发者在代码里做好约束比如删除用户时同步清理收藏记录。3.2 核心表的字段设计细节用户表比较标准包含id、username、password、salt、phone、avatar、role、status、create_time。这里重点说下role字段用1表示普通用户0表示管理员。后台管理页面的权限拦截依赖这个字段不是管理员的用户就算是登录状态访问后台接口也会被拦截器拒绝。资讯表是我花时间最多的一张表。字段包括id、title、summary、content、cover_image、category_id、author_id、view_count、comment_count、status、publish_time。content字段用的是TEXT类型能存6万多字符的正文对汽车评测类长文完全够用。status字段用来区分草稿和已发布管理员在后台写了文章可以先存草稿等配好封面图再发布。评论表和数据表要特别提一下索引设计。评论表的查询场景非常固定就是by article_id查列表所以我给article_id建了普通索引。资讯表的列表页经常按category_id和publish_time筛选排序我建了一个联合索引(category_id, publish_time)。别小看这两个索引数据量上来以后索引的有无能差出一个数量级的查询时间。3.3 初始化SQL脚本的坑与处理项目里附带了一份init.sql导入之后能直接跑起来。我在整理这份SQL时踩过一个坑MySQL的版本差异导致datetime默认值写法不同。老版本的MySQL允许datetime字段直接设置DEFAULT CURRENT_TIMESTAMP而某些版本需要写成DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP。如果导入时报错建议把SQL里的时间字段默认值统一改为手动插入由Java代码在insert时set值彻底绕开数据库版本差异。另外数据库字符集记得用utf8mb4而不是utf8。utf8在MySQL里是utf8mb3的别名存不了emoji表情用户在评论里发个表情符号就会报Incorrect string value错误。我在本地开发时遇到过一次改成utf8mb4之后问题再没出现过。4. 环境准备与部署全流程4.1 本地开发环境搭建本地调试我用的组合是IntelliJ IDEA配JDK 8数据库用MySQL 5.7项目管理工具Maven 3.6。这几个版本组合经过多次验证不会出现SpringBoot 2.x与JDK版本不兼容的问题。要是你本机装的是JDK 17建议把IDEA里Project Structure的SDK以及Maven的JRE都设置为本地JDK 17然后重新编译SpringBoot 2.5对JDK 17是兼容的但项目属性里指定的Java版本要改成17。数据库连接信息统一写在application.yml里。我习惯用YAML格式缩进比properties清晰多环境配置也方便。核心配置如下server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/car_news?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456注意url里的参数useUnicode和characterEncoding必须写上否则中文乱码serverTimezone最好显式指定为Asia/Shanghai新版MySQL驱动不带时区参数会报错。密码换成你自己的数据库密码。4.2 打包和部署到服务器的完整步骤开发环境下直接右键运行主类就能启动但部署到服务器就要打成可执行jar包了。打包前先确认pom.xml里打包方式为jar并且SpringBoot的maven插件已加入。执行命令很固定mvn clean package -DskipTests生成的jar在target目录下名字类似car-news-0.0.1-SNAPSHOT.jar。把这个jar上传到服务器后台启动的命令是nohup java -jar car-news-0.0.1-SNAPSHOT.jar --server.port8080 app.log 21 nohup保证关掉终端后进程不会退出app.log用来记录运行日志排查故障全靠它。服务器上必须提前装好JDK和MySQL版本与本地保持一致。我用的是CentOS 7.9服务器安装OpenJDK 8和MySQL 5.7的流程网上都有这里不展开但要提醒一句服务器防火墙和云服务商的安全组都要放行8080端口否则浏览器永远访问不通。数据库迁移有两种方式一种是在服务器上执行init.sql脚本另一种是用Navicat导出现有数据库再导入。我推荐前者干净且可重复执行。导入命令mysql -u root -p car_news /home/www/init.sql4.3 Nginx反向代理配置jar包直接跑在8080端口但生产环境我习惯加一层Nginx做反向代理。好处有三个一是可以直接通过80端口访问不用输入端口号二是静态资源交给Nginx处理减轻Tomcat压力三是将来如果加HTTPS证书配置位置就在Nginx层不需要改应用代码。Nginx配置里一个关键server块server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } location /static/ { alias /home/www/static/; expires 7d; } }X-Real-IP和X-Forwarded-For这两个参数很重要。加了Nginx之后如果不设置这两个头后端程序拿到的客户端IP永远是127.0.0.1评论区的用户IP记录就会全部失效。4.4 部署后的验证清单上线后不要急着给用户发链接先用自测清单过一遍访问域名或IP首页正常打开且图片能显示注册一个新账号退出再登录确认Session正常发布一条测试资讯前台能看到且阅读数正常增加发表一条评论和一条回复确认嵌套展示正确后台登录管理员账号检查资讯管理页面能加载出列表查看app.log确认没有报错堆栈如果哪一步不对先看日志大多数问题日志里都有明确线索。5. 常见问题排查与性能优化实录5.1 部署和运行中的高频问题先整理一份我实际遇到或者帮别人排查过的问题速查表都是高频且容易复现的。现象原因解决办法启动时报Port 8080 was already in use端口被占用换端口运行或kill掉占用进程数据库连接失败Access denied for user账号密码权限不对检查数据库账号和授权范围中文乱码连接参数没写编码或数据库字符集不对url加characterEncodingutf8mb4数据库重启前确认字符集页面样式全丢静态资源路径不对检查模板页面引用的静态资源路径排除拦截器拦截后缀分页不生效分页插件没注册配置MybatisPlusInterceptor Bean上传图片后无法访问静态资源映射没配置或路径不对配置资源映射目录确认nginx静态目录权限端口占用是最常遇到的启动问题排查命令是netstat -tunlp | grep 8080找到PID后kill掉或者干脆改个端口。这里建议第一次部署时就规划好端口避免上线后要改配置重启。静态资源404的问题也很典型。SpringBoot默认把/static/目录映射到classpath:/static/但上传到本地的图片并不在classpath里。我的做法是在配置里增加一个自定义资源映射Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: System.getProperty(user.dir) /upload/); } }这样上传目录就在jar包同级目录的upload文件夹下不会因为重新打包而丢失。5.2 高并发场景下的简单优化实践汽车资讯网站的并发量一般集中在资讯发布后的几小时内大量用户同时浏览新文章。这种读多写少的场景最有效的优化手段就是加缓存。我在项目里对资讯详情页做了简单的本地缓存private CacheString, Article localCache CacheBuilder.newBuilder() .maximumSize(200) .expireAfterWrite(10, TimeUnit.MINUTES) .build();这是Guava的本地缓存把热点资讯缓存10分钟有效期内反复刷详情页不会打数据库。对于再大一点的并发可以把本地缓存换成Rediskey用article:detail:IDvalue用JSON字符串设置过期时间。这种改造对现有业务代码的侵入很小主要在Service层动手。数据库层面我检查了所有SQL的执行计划重点优化了两条慢查询一条是资讯列表按分类排序的查询加了联合索引后从全表扫描变成索引范围扫描另一条是车型库的列表查询本来做了多表join后来发现直接拆成单表查询再组装数据性能反而更好这算是经验之谈——join不总是最优解尤其在数据量不大的时候。5.3 安全性加固的几个细节分享几个安全层面的细节可能很多课程设计不会讲但实际有用。第一防止SQL注入。用MyBatis Plus的LambdaQueryWrapper天然使用预编译参数不会拼接SQL字符串所以在数据查询层面安全性有了基本保障。但要注意排序字段如果允许前端传入要做白名单校验不然order by后面的字段名很容易被注入。第二防止XSS攻击。评论内容一定不能原样输出到页面上前端的处理是转义HTML。如果用户提交了一段script标签页面直接显示成纯文本而不是执行它。我在前端模板里对评论内容使用了Thymeleaf的th:text而不是th:utext这就保证了默认转义。第三上传文件的安全检查。头像上传和资讯封面上传都要加限制只允许jpg、png、gif这三种后缀并且校验文件头部的magic number防止把恶意脚本伪装成图片传上去然后通过访问路径执行。SpringBoot的MultipartFile提供getContentType方法可以辅助判断但不能只依赖这个因为它是客户端声明的可以伪造。6. 后续可以扩展的方向这个系统如果作为毕设已经可以完整答辩了。但如果想让它更有亮点我有几个扩展方向可以参考。一个是把资讯检索升级为全文检索引入Elasticsearch或者轻量级的Lucene方案。现在网站内容多了以后用户想搜某款车的评测靠SQL的LIKE模糊查询响应会越来越慢。Elasticsearch的倒排索引在文本搜索场景下优势明显而且SpringBoot整合它的方式很成熟会有比较新的技术加分。另一个方向是数据可视化。虽然后台已经有一些简单的统计看板比如每日发布量、用户注册量曲线但可以做得更炫。引入ECharts或者AntV把收藏热度、评论活跃度、分类占比做成交互式图表视觉冲击力很强答辩时很出彩。再有一个很实际的扩展是内容推荐。根据用户的浏览记录和收藏行为给用户推荐相似的汽车资讯。简单做法是基于标签匹配比如用户收藏过新能源车的内容就在首页推荐其他新能源相关资讯。复杂一点的做法可以引入协同过滤算法让系统从“有点聪明”变成“像个懂车的朋友”。我在实际使用中的体会是做这类全栈项目最忌讳的是贪多求全把能想到的功能都堆上去。先把资讯、用户、评论、车型库这几条主干跑通部署上线经历一遍真实的坑再根据时间和精力去选择最感兴趣的方向做深一点。这个项目从零到一的过程比最终上线的功能列表更能锻炼人。