企业官网建设流程全解析

简介：在Java后端开发中，SpringBoot与MySQL组合是构建数据驱动型Web应用最经典的方案之一。SpringBoot通过自动配置与约定优于配置大幅简化项目启动流程，MySQL则提供稳定可靠的关系型数据存储。二者结合，形成从Controller控制层到Service业务层再到Mapper数据访问层的标准分层架构，为开发者提供了清晰的职责边界与高效的开发体验。无论是用户登录鉴权、新闻增删改查，还是分页排名、文件上传，这类高频业务场景都依赖这套基础技术栈。理解其核心原理和工程实践，有助于快速上手各类内容管理系统的开发。本文以一款基于SpringBoot+MySQL的新闻网站项目为例，从数据库设计、核心代码实现到部署上线，完整拆解项目落地的全过程，并总结常见踩坑排查技巧，帮助读者将理论转化为可运行的工程能力。

基于SpringBoot+MySQL的新闻网站：从源码到上线的完整拆解

如果你正打算找一份能练手、能交作业、能写进简历的 Java Web 项目，那“基于 SpringBoot+MySQL 的新闻网站”绝对是一个绕不开的经典选择。前阵子我刚好把一个新闻网站的源码和数据库完整过了一遍，顺手做了不少改造和修复。这篇文章就把整个项目的结构、核心代码、数据库设计、部署经验，以及我在实际踩坑后总结的排查思路，一次性说清楚。

这套项目属于典型的“小而全”案例：SpringBoot 负责后端接口和数据业务逻辑，MySQL 负责数据持久化，前端用模板引擎或静态页面展示，整套东西跑起来就是一个能浏览新闻、管理分类、维护用户信息的完整网站。对于刚学完 SpringBoot 基础、想通过项目夯实技能的人，或者正在准备课程设计、毕业设计的人，都特别合适。看完这篇文章，你不仅能把它跑起来，还能知道每一处代码背后的设计意图，遇到问题也知道去哪里排查。

另外再说一句，这个项目虽然看起来简单，但它包含了一套 Web 系统最常见的几个能力：用户登录与权限控制、新闻增删改查、分页排行榜、文件上传（新闻配图）、分类管理等。这些能力放到任何企业级项目中，都是高频场景，把它们吃透，比单纯背面试题有价值得多。

1. 项目整体设计与技术选型

1.1 为什么是 SpringBoot + MySQL，而不是其他组合

先说说技术选型。很多初学者喜欢纠结“到底用 SSH（Spring+Struts+Hibernate）还是 SpringBoot”，我的答案是：除非你的课程大纲强制要求 SSH，否则一律选 SpringBoot。原因很直接：SpringBoot 内置了 Tomcat，省去了一堆 XML 配置，通过自动配置把“约定大于配置”贯彻到了极致。你用 Spring 写一个 Hello World 可能要配置 10 个文件，用 SpringBoot 只需要一个类加一行注解。

MySQL 更是没什么争议的选择。它是开源数据库里生态最成熟、资料最多、最容易上手的关系型数据库。对新闻网站这种以结构化数据为主、事务要求不算极端的场景，MySQL 有着极高的性价比。配合 Navicat、DBeaver 这类图形化工具，建表、导数据、调试 SQL 都非常方便。

这套组合在市面上还有一个非常大的优势——学习成本低，岗位需求量大。你去招聘网站搜一下“Java 工程师”，十有八九要求熟悉 SpringBoot，大部分要求熟悉 MySQL。所以做这个项目，本质上就是在提前练习未来的工作技能。

1.2 项目目录结构与分层思想

我把这套新闻网站的源码目录结构整理了一下，大致是这个样子：

src/main/java/com/news/ ├── NewsApplication.java // 启动类 ├── controller/ // 控制层，接收请求 │ ├── LoginController.java │ ├── NewsController.java │ ├── CategoryController.java │ └── UserController.java ├── service/ // 业务层，处理逻辑 │ ├── NewsService.java │ ├── UserService.java │ └── CategoryService.java ├── mapper/ // 数据访问层（MyBatis-Plus） │ ├── NewsMapper.java │ ├── UserMapper.java │ └── CategoryMapper.java ├── entity/ // 实体类 │ ├── News.java │ ├── User.java │ └── Category.java └── config/ // 配置类 └── WebConfig.java

有些版本会多一层vo（View Object）用来封装返回给前端的对象，有些会把工具类放在utils包下，这个按个人习惯来，但核心的三层结构（Controller → Service → Mapper）一定要清晰。我见过不少新手把业务逻辑全写在 Controller 里，一个方法几百行，后面调试的时候想哭都哭不出来。

分层的好处，我用一句话概括：Controller 只负责接收参数和返回结果，Service 只负责业务逻辑，Mapper 只负责和数据库打交道。每一层各司其职，任何一层出问题，都能快速定位。而且这个结构在企业开发中几乎就是标配，你提前养成习惯，对你将来的工作帮助很大。

1.3 核心功能模块拆解

以一个常规的新闻网站项目为例，功能模块一般包含：

• 用户模块：注册、登录、登出、修改密码
• 新闻模块：新闻列表、新闻详情、新闻发布、新闻编辑、新闻删除
• 分类模块：分类列表、分类管理
• 前端页面：首页、列表页、详情页、登录注册页、后台管理页

听起来功能不多，但你把每个模块拆开去看，里面覆盖的点非常全面。比如新闻列表要支持分页，分页就涉及到 SQL 的LIMIT语法；新闻发布时间要排序，这就涉及 MySQL 的ORDER BY；新闻配图要上传，这就涉及服务器文件存储和访问映射。这些全都是实战中天天要用的技能。

所以我的建议是：拿到这套项目之后，不要只为了“跑起来”而跑，而是按照模块逐个去读源码，把每个模块对应的前端请求、后端接口、数据库操作串成一条线。这样做完一遍，你对整个 Web 开发流程的理解会有一个质的提升。

2. 数据库设计与核心表结构

2.1 建表思路：三张核心表搞定大部分需求

数据库是这个项目的基础，我先看数据库脚本。大多数新闻网站的表结构都包含三张核心表：用户表、新闻表、分类表。如果是更完整一点的版本，还会有评论表和收藏表。

下面是我提取并整理过的建表 SQL（以 MySQL 5.7 及以上版本为例）：

CREATE DATABASE IF NOT EXISTS news_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE news_db; CREATE TABLE `t_user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `username` varchar(50) NOT NULL COMMENT '用户名', `password` varchar(100) NOT NULL COMMENT '密码（建议MD5加密存储）', `nickname` varchar(50) DEFAULT NULL COMMENT '昵称', `role` tinyint(4) DEFAULT 1 COMMENT '角色：1普通用户 2管理员', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; CREATE TABLE `t_category` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(50) NOT NULL COMMENT '分类名称', `sort` int(11) DEFAULT 0 COMMENT '排序号', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='新闻分类表'; CREATE TABLE `t_news` ( `id` int(11) NOT NULL AUTO_INCREMENT, `title` varchar(200) NOT NULL COMMENT '新闻标题', `content` text COMMENT '新闻内容', `image` varchar(255) DEFAULT NULL COMMENT '封面图地址', `category_id` int(11) DEFAULT NULL COMMENT '分类ID', `view_count` int(11) DEFAULT 0 COMMENT '浏览量', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '发布时间', `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`), KEY `idx_category_id` (`category_id`), KEY `idx_create_time` (`create_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='新闻表';

2.2 表结构设计里的关键细节

我在看这套项目的表结构时，有几点细节值得拿出来说一说。

第一是utf8mb4字符集。很多老教程喜欢用utf8，但utf8在 MySQL 中并不是真正的“全部 UTF-8”，它只能存储最多 3 个字节的字符。一旦新闻内容里出现生僻字或 emoji 表情，就会报错或者变成乱码。现在统一用utf8mb4是标准做法，它能完整覆盖 4 字节字符。尤其是新闻内容这块，用户转发、复制粘贴内容时很容易带上特殊符号，字符集不对就等着挨骂吧。

第二是时间字段用datetime而不是varchar。有些偷懒的开发者会用字符串存时间，看起来方便，但后续做排序、范围查询、格式化输出的时候非常痛苦。数据库提供的datetime类型配合CURRENT_TIMESTAMP默认值，能保证时间格式统一，而且 SQL 里的排序和比较操作能直接使用原生能力，效率更高。

第三是索引的建立。新闻表里的category_id和create_time是两个高频查询字段，按分类查新闻、按时间排序是新闻网站最常用的两个查询场景，所以需要加索引。但注意，不要每个字段都加索引，索引过多会拖慢写入速度，占用磁盘空间。索引这种东西，够用就好。

2.3 初始化数据：让项目一启动就有内容可看

很多时候你拿到源代码，数据库是空的，首页打开除了一个框架什么都没有，那体验太糟糕了。我建议你把初始化数据一起导入。常用的做法是在resources目录下放一个data.sql或init.sql，或者在 SpringBoot 配置里开启spring.sql.init.mode=always让项目启动时自动执行。

建完表后，至少插入一个管理员账号和几篇测试新闻，比如：

INSERT INTO `t_user` (`username`, `password`, `nickname`, `role`) VALUES ('admin', 'e10adc3949ba59abbe56e057f20f883e', '管理员', 2); -- 密码为 123456 的 MD5 值 INSERT INTO `t_category` (`name`, `sort`) VALUES ('科技', 1), ('体育', 2), ('财经', 3); INSERT INTO `t_news` (`title`, `content`, `category_id`, `view_count`) VALUES ('SpringBoot 3.0 正式发布', '这是科技频道的一条测试新闻内容...', 1, 120), ('本地足球队夺冠', '这是体育频道的一条测试新闻内容...', 2, 85);

e10adc3949ba59abbe56e057f20f883e就是123456的 MD5 值，这种预置数据能让登录功能“开箱即用”，省去你先注册再登录的流程。

3. 核心功能模块的代码实现解析

3.1 用户登录与权限控制的完整流程

用户登录是所有 Web 项目的“门面”，也是面试中必问的内容。我看过的这份新闻网站源码里，登录处理比较常规，但不乏可圈可点之处。

先看 Controller 层的代码结构：

@Controller public class LoginController { @Autowired private UserService userService; @PostMapping("/login") public String login(String username, String password, HttpSession session, Model model) { User user = userService.login(username, password); if (user != null) { session.setAttribute("loginUser", user); return "redirect:/news/list"; } model.addAttribute("msg", "用户名或密码错误"); return "login"; } }

这段逻辑非常清晰：接收用户名和密码 → 调用 Service 层做校验 → 成功则写入 Session 并跳转到新闻列表页 → 失败则返回错误提示。

Service 层的实现：

@Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; @Override public User login(String username, String password) { // 实际项目中建议对密码做加密处理，而不是明文比对 String md5Password = DigestUtils.md5DigestAsHex(password.getBytes()); return userMapper.selectOne(new LambdaQueryWrapper<User>() .eq(User::getUsername, username) .eq(User::getPassword, md5Password)); } }

这里有几个值得注意的地方。

密码用 MD5 加密存储，这一点在课程设计中足够用，但在真实项目里我更推荐 BCrypt，因为 MD5 已经能被彩虹表轻松破解。如果你只是交作业，MD5 没问题；如果你想把项目写进简历，建议把加密方式升级为BCryptPasswordEncoder，Spring Security 原生支持，而且加盐机制能大幅提高安全性，面试官问起来你也能说出个所以然。

至于权限控制，这个项目采用的是“Session 判断 + 拦截器”的模式。后台管理的页面会先判断 Session 里有没有loginUser，没有就跳转登录页，有就继续访问。代码大致如下：

public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); if (session.getAttribute("loginUser") == null) { response.sendRedirect("/login"); return false; } return true; } }

提示：如果你在源码中看到了WebMvcConfigurer的实现类，里面通常注册了拦截器并配置了放行路径，比如放行静态资源和登录接口。这个配置类非常重要，很多新手折腾半天发现“页面永远跳转登录”，就是拦截器路径没放行导致死循环了。

3.2 新闻增删改查：你绕不开的 CRUD 实战

新闻模块是整个网站的核心，其操作就是标准的增删改查。在 MyBatis-Plus 的加持下，CRUD 代码量非常少。以新闻列表分页查询为例：

@GetMapping("/news/list") public String list(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, @RequestParam(required = false) Integer categoryId, Model model) { Page<News> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<News> wrapper = new LambdaQueryWrapper<>(); if (categoryId != null) { wrapper.eq(News::getCategoryId, categoryId); } wrapper.orderByDesc(News::getCreateTime); Page<News> result = newsMapper.selectPage(page, wrapper); model.addAttribute("page", result); return "newsList"; }

这段代码用到了 MyBatis-Plus 的Page分页插件和LambdaQueryWrapper条件构造器，把分页和条件查询都封装得非常优雅。你不需要手动写LIMIT ? OFFSET ?，也不需要拼接WHERE子句，一行selectPage搞定。

增删改就更是标准操作了，核心代码几乎就一行：

// 新增 newsMapper.insert(news); // 修改 newsMapper.updateById(news); // 根据ID查询 newsMapper.selectById(id); // 删除 newsMapper.deleteById(id);

3.3 文件上传：新闻配图背后的完整链路

新闻网站通常需要给新闻配图，所以文件上传功能是躲不开的。这也是很多初学者第一次接触“服务器文件存储”概念的入口。

核心配置在application.yml中：

spring: servlet: multipart: max-file-size: 10MB max-request-size: 10MB

然后提供一个文件上传接口：

@PostMapping("/news/uploadImage") @ResponseBody public String uploadImage(@RequestParam("file") MultipartFile file, HttpServletRequest request) { if (file.isEmpty()) { return "上传失败"; } String originalFilename = file.getOriginalFilename(); String ext = originalFilename.substring(originalFilename.lastIndexOf(".")); String fileName = System.currentTimeMillis() + "_" + UUID.randomUUID().toString().replace("-", "") + ext; String datePath = new SimpleDateFormat("yyyyMMdd").format(new Date()); String realPath = request.getServletContext().getRealPath("/") + "upload/" + datePath + "/"; File dir = new File(realPath); if (!dir.exists()) { dir.mkdirs(); } try { file.transferTo(new File(realPath + fileName)); return "/upload/" + datePath + "/" + fileName; } catch (IOException e) { e.printStackTrace(); return "上传失败"; } }

文件名用“时间戳+UUID”拼接，能有效避免同名文件互相覆盖；按日期建目录，可以避免一个目录下文件过多导致访问变慢。这些细节都是实际生产中的常用手法，虽然代码看着简单，但思路很值得学习。

3.4 前端页面与模板引擎的配合方式

这套新闻网站源码的前端，有的版本用的是 JSP，有的用 Thymeleaf，也有的用静态 HTML + Ajax。我强烈建议你优先选择 Thymeleaf 版本，因为它是 SpringBoot 官方推荐的模板引擎，和 SpringBoot 的整合是最顺滑的。

Thymeleaf 页面的核心片段大概是这样的：

<tr th:each="news : ${page.records}"> <td th:text="${news.title}">新闻标题</td> <td th:text="${news.categoryName}">分类</td> <td th:text="${news.viewCount}">浏览量</td> <td th:text="${#temporals.format(news.createTime, 'yyyy-MM-dd HH:mm')}">发布时间</td> <td> <a th:href="@{/news/detail/{id}(id=${news.id})}">查看</a> <a th:href="@{/news/edit/{id}(id=${news.id})}">编辑</a> <a th:href="@{/news/delete/{id}(id=${news.id})}" onclick="return confirm('确认删除吗？')">删除</a> </td> </tr>

这套代码里没有任何复杂的 JavaScript 框架，就是服务端渲染的标准玩法。页面代码在服务端执行，将数据填充到模板中，然后返回完整的 HTML 给浏览器。好处是简单直接，对 SEO 友好，且初学者容易理解整个数据流。

4. 项目启动与部署：从零到可访问的完整过程

4.1 环境准备：JDK、Maven、MySQL 的版本搭配

在运行这个项目之前，先要确保本机环境没有问题。我推荐的环境搭配是：

• JDK 1.8 或 JDK 11（SpringBoot 2.x 均可支持）
• Maven 3.6 以上
• MySQL 5.7 或 8.0
• IDE 使用 IntelliJ IDEA 或 Eclipse

这里特别注意一下 SpringBoot 的版本。如果你的项目是 SpringBoot 2.x，那用 JDK 8 就可以了；如果你用的是 SpringBoot 3.x，那必须 JDK 17 以上，因为 SpringBoot 3 基于 Jakarta EE 9，对 JDK 版本有硬性要求。我看到不少人把 SpringBoot 版本升到 3.x 之后，JDK 还在 8，结果项目怎么都启动不起来。所以我的建议是：先用源码里锁定的版本跑通，再考虑升级。

4.2 配置数据库连接：一处在 application.yml 中搞定

数据库连接信息通常在src/main/resources/application.yml中配置。你需要把它改成你自己本机的数据库账号密码：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/news_db?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver

这里面有几个配置项非常容易踩坑：

• serverTimezone=Asia/Shanghai如果不加，高版本 MySQL 驱动会报时区错误。
• characterEncoding=utf8mb4要和你数据库的字符集保持一致，否则中文乱码。
• useSSL=false是在本地开发时关闭 SSL 校验，避免告警。
• driver-class-name在 MySQL 8.0 下必须写com.mysql.cj.jdbc.Driver，老版本的com.mysql.jdbc.Driver已经废弃。

4.3 启动步骤与常见告警

配置好数据库之后，启动流程非常简单：

1. 用 IDEA 打开项目，等待 Maven 依赖下载完成。
2. 在数据库中执行news.sql脚本，完成建库建表和数据初始化。
3. 修改application.yml中的数据库密码。
4. 运行NewsApplication.java主类。
5. 浏览器访问http://localhost:8080。

启动过程中如果看到红色的ERROR日志，不要慌，先看异常信息。90% 的启动失败都是数据库连接问题：要么是密码不对，要么是库没建好，要么是端口被占用。如果出现Port 8080 was already in use，说明你的 8080 端口被别的程序占了，可以通过netstat -ano | findstr 8080找到占用进程，或者直接在配置里把端口改成 8081。

5. 常见问题与排查技巧实录

5.1 问题速查表

我在跑这套项目时整理了一份常见问题清单，很多问题都是初学者会反复踩的坑，做成表格方便你对照排查。

5.2 MyBatis-Plus 的坑：Mapper 接口扫描与分页插件

MyBatis-Plus 虽然在代码层面很方便，但它有两个特别容易踩的坑。

第一个是 Mapper 扫描。别忘了在启动类上添加@MapperScan("com.news.mapper")注解，或者在每个 Mapper 接口上加@Mapper注解。否则项目启动时会报找不到 Mapper 的错，原因是 Spring 容器不知道去哪里找数据访问层接口。

第二个是分页插件。如果你写了selectPage但发现分页不生效，大概率是没配置 MyBatis-Plus 的分页拦截器。SpringBoot 2.x 中需要添加如下配置：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

没有这个配置，selectPage查出来的数据会是全量的，强行分页还会得到奇怪的结果。

5.3 项目拿到手以后，第一步应该做什么

很多同学拿到一个开源项目后，第一时间就点运行，结果报错一堆，当场心态爆炸。我根据经验总结了一个比较稳妥的检查顺序：

先读README文件。虽然不是每个项目都有，但只要作者写了 README，里面通常包含环境要求、运行步骤和注意事项。第二步看pom.xml，确认 SpringBoot 版本和依赖框架。第三步看application.yml，检查数据库配置、端口配置，这里的信息基本决定了项目能否启动。第四步看启动类，确认 Mapper 扫描是否配置。最后再执行news.sql，确认数据表结构。

这一步做完，项目跑不起来的概率已经降到了最低。

6. 从课程设计到面试谈资：这个项目的价值挖掘

6.1 在简历上如何描述这个项目

很多同学做的项目内容差不多，但简历上的描述千差万别。有人写“熟悉新闻网站开发”，有人写“独立完成新闻网站”，这都没什么亮点。我建议你用“技术栈 + 核心功能 + 量化成果”的结构来写。

可以参考这个表述：基于 SpringBoot + MySQL + MyBatis-Plus 构建新闻管理系统，实现用户注册登录、新闻分类管理、新闻发布与检索、浏览量统计及后台管理功能；数据库设计包含用户、分类、新闻三张核心表，并通过索引优化新闻列表查询效率；在项目中负责从数据库设计、接口开发到部署上线的全流程开发，并通过拦截器实现简单的登录鉴权。

面试官看到这种描述，不用追问，就能知道你的项目规模和技术含量。

6.2 项目里可以继续优化的点

如果你不满足于当前版本，可以尝试从这些方向把它升级为分布式或微服务风格的“进阶版”：

• 把密码加密从 MD5 换成 BCrypt。
• 引入 Spring Security 或 Sa-Token 做更完善的认证授权。
• 用 Redis 做新闻浏览量的缓存，解决高并发下的热键问题。
• 增加新闻全文搜索，用 Elasticsearch 替代LIKE模糊查询。
• 将图片上传改用云存储 OSS，避免本地存储的扩展性问题。
• 增加评论和点赞功能，让网站的互动性更强。

这些点每做完一个，你对该项目的理解就会上一个台阶。最重要的是，面试时你能说出每个优化背后的“为什么”，这才是真正的亮点。

6.3 这套项目中的通用能力迁移

最后我想说，不要把自己限定在“新闻网站”这个概念里。把它抽象一下，这就是一个“内容管理类系统”的典型实现。你把新闻换成商品，加上购物车和订单表，就变成了电商系统；换成文章，加上标签和评论，就变成了博客系统；换成课程，加上视频地址和选课表，就变成了在线教育系统。

所以，你会了这一套，未来做任何 CRUD 为主的业务系统，核心逻辑都相通。这段时间我自己的体会是：表面上是做完了新闻网站，实际上是把 Web 开发中“请求 → 处理 → 存储 → 渲染”这条链路彻底搞清楚了。这条链路才是真正起作用的东西，它不会因为你换一个项目、换一张表就失效。

我最后再分享一个小技巧：在跑通整个项目之后，建议你打开数据库客户端，随便改几条数据，再刷新页面，直观感受一下数据库和网页之间的联系。这个“改数据 → 刷页面 → 看变化”的循环，我到现在都觉得是理解前后端关系最有效的方式，没有之一。

本文还有配套的精品资源，点击获取