你知道大学里最常被问的一句话是什么吗——“你毕设做的啥”如果你打开过 CSDN、GitHub 或者各种毕设源码平台大概率见过“基于SpringBootWeb的小游戏集成网站”这样的题目。听起来挺唬人拆开看其实就是一个简化版的小游戏平台前端网页展示游戏列表点击某个游戏就能在浏览器里玩起来后台则是标准的 SpringBoot 工程。这篇文章我打算换个讲法不念需求文档不抄部署手册而是把这类项目从立项到部署的完整链路拆开结合我这些年看源码、改项目、帮人排查部署问题的实际经验把“源码lw部署文档讲解资料”这套东西背后的设计逻辑和实操细节讲透。无论你是正要选毕设题目的学生还是想通过一个完整 Web 项目入门 SpringBoot 的开发者这篇都能帮你少走弯路。尤其是部署环节那些“明明跟着文档做却还是报错”的问题我会把常见坑一个个揪出来。1. “游戏集成网站”到底是个什么项目需求拆解与目标定位很多人拿到这类题目第一反应是“游戏网站那是不是要写很多游戏逻辑”这是最大的误解。小游戏集成网站的核心价值不在“造游戏”而在“集成”。说白了这就是一个内容管理加展示平台游戏本身要么是现成的开源 HTML5 小游戏要么是嵌入的第三方游戏链接。你要做的是把“游戏管理”和“用户体系”这两块业务做扎实。理解这一点整个项目的难度预期就对了。1.1 典型功能清单与模块划分一个完整的游戏集成网站在课程设计或毕设层面通常包含以下模块用户模块注册、登录、注销可能还有个人中心、修改密码、收藏游戏。游戏模块游戏列表展示、按分类筛选、搜索、游戏详情页、游戏播放/游玩页。分类模块按游戏类型动作、益智、休闲、射击等分类管理。后台管理模块管理员维护游戏数据包括添加、编辑、下架、删除游戏通常还有分类管理和用户管理。从用户视角看这个网站的完整使用流程就是游客浏览游戏列表 → 注册登录 → 收藏某个游戏 → 点击开始游玩 → 系统记录游玩次数。这个闭环如果都能跑通项目在功能完整性上已经超过大多数同类课设了。1.2 这类项目为什么在毕设/课设里如此常见技术栈主流是最直接的原因。SpringBoot 模板引擎或前后端分离 MyBatis MySQL这一套组合覆盖了后端开发的绝大部分核心知识点依赖注入、MVC 分层、ORM 映射、会话管理、拦截器、文件上传、异常处理。而游戏集成场地本身又带来了“非业务复杂性”之外的展示效果答辩时点开网页、鼠标点两下就能玩演示天然比“图书管理系统”这种 CRUD 项目更有记忆点。另一个原因是它的扩展性极好。同样的骨架可以往里面塞新闻资讯、视频分享、工具导航、壁纸收藏……本质上都是“内容对象 用户体系 后台维护”这三板斧。所以你会发现这类项目在源码交易平台上的标题经常是“基于SpringBoot的XX系统源码lw部署文档讲解等”它们底层长得都很像。1.3 项目落地所需的前置技术栈如果你是准备以此作为学习项目先对照一下自己是否具备这些基础Java 基础语法、面向对象思想、集合框架。Maven 依赖管理的基本概念知道 pom.xml 是干什么的。SQL 基础会写增删改查懂表关联。HTML/CSS/JavaScript 基础至少能看懂前端页面的结构。如果选 Thymeleaf 模板方案后端和前端代码是混在一个工程里的对前端要求不高。对 HTTP 协议有基本的认知知道 GET/POST 的区别理解 Session 与 Cookie 的工作机制。这些都没问题的话这个项目你完全驾驭得住。如果某个环节还比较虚这篇文章后半部分也会给出具体的学习和避坑思路。2. 技术选型的底层逻辑SpringBoot 为什么能撑起这类网站标题里写了“基于SpringBootWeb”可同样满足这个条件的技术组合至少有好几种。选型不是越新越好也不是越复杂越好而是要匹配项目规模、学习成本、答辩展示需求和部署复杂度。这一节我把几个关键决策点逐个说清楚。2.1 Spring 框架选型Boot 不是比 MVC 高级而是更“省事”早期做 Java Web 项目要写一堆 web.xml 配置配置 DataSource、配置 DispatcherServlet、配置事务管理器三天时间可能都在跟 XML 搏斗。SpringBoot 出现的意义就是将这些繁琐的、约定俗成的配置自动化。它默认内置了 Tomcat启动一个 Web 项目只需要一个带SpringBootApplication注解的主类。它真正解决的问题有三个依赖冲突治理通过 Starter 机制封装了某个技术栈的完整依赖集合。引入spring-boot-starter-webMVC、Jackson、Tomcat 等 Web 应用需要的包一次性到位版本由 SpringBoot 的 BOMBill of Materials统一管理。自动配置SpringBoot 会基于 classpath 下的依赖自动推断配置。引入了spring-boot-starter-data-redis就会自动配置 RedisTemplate类路径有 H2 驱动和 JPA 实现就会自动配置数据源。嵌入式容器不用再单独装 Tomcatjava -jar一键启动。这一点对部署文档的帮助是决定性的也是后面讲部署时“一条命令跑起来”的基础。2.2 视图层方案模板引擎 vs 前后端分离我见过太多学生一上来就想整 Vue SpringBoot 前后端分离理由是“企业里都这么干”。话虽没错但要看你做的是什么项目。如果目标是用最少的时间拿到一个完整的、能跑通的、代码能讲清楚的作品Thymeleaf 服务端渲染是性价比更高的选择。理由有三点部署单元只有一个 jar 包没有跨域、没有 Nginx 静态资源转发出问题的环节少一半。代码阅读链路短浏览器地址栏发起请求 → Controller 放回 ModelAndView → 模板渲染 HTML一个完整的 MVC 闭环一目了然答辩时特别好讲。对于游戏集成这种场景页面本身不需要高互动性模板引擎完全够用。如果你已经对 Vue 很熟或者导师明确要求前后端分离那当然可以选。但不要为了“看起来高级”而给自己增加两倍的工作量和排错难度。我见过不少学生在一个跨域配置上卡了两天没能把登录状态打通。2.3 登录会话方案Session 优先JWT 在这个场景是过度设计游戏集成网站的用户体系非常简单注册、登录、保持登录状态、判断“当前用户是否已登录”来决定能不能收藏。这个场景用传统的 HttpSession 就能完美解决。SpringBoot 的spring-boot-starter-web内置了所有会话管理能力你只需要在需要用户信息的 Controller 方法里注入HttpSession或者用SessionAttribute取对象。JWT 也不是不能用但无状态认证引入的是另一个频道的复杂度Token 存哪、过期了怎么处理、注销怎么办、请求拦截器里怎么解析。对于一个单体应用、单服务器部署的课设项目你根本用不上无状态认证带来的横向扩展优势反而要处理一堆额外逻辑。技术选型有一条朴素的原则复杂度应该由业务需求驱动而不是由技术好奇心驱动。2.4 持久层方案MyBatis-Plus 让 CRUD 代码量降一半MyBatis 是很多 Java 项目的事实标准它对 SQL 的控制粒度更细。但如果你用原生 MyBatis每写一个实体类就要配套写一个 Mapper 接口和 Mapper XML并且所有单表增删改查都要手敲 SQL工作量巨大。MyBatis-Plus 在 MyBatis 之上封装了通用 Mapper单表 CRUD 不需要写任何 SQLselectById、selectPage、updateById直接用现成的。我推荐在项目里引入 MyBatis-Plus 还有一个原因它的LambdaQueryWrapper写条件查询非常流畅。比如“根据分类 ID 查游戏列表并按点击量排序”一行链式调用就能完成代码可读性强答辩讲起来也顺畅。但注意一点MyBatis-Plus 是对 MyBatis 的增强而非替代多表关联查询依然要自己在 XML 里写 SQL。游戏分类联查这类场景建议老老实实用自定义 SQL不要试图用 Wrapper 硬拼 JOIN。下面是我在建这类项目时常用的依赖配置块直接复制进pom.xml就能用版本号建议根据你本地的 SpringBoot 版本做调整dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency2.5 关于“SpringBoot版本太高”的坑热词里有一条“springboot版本太高”值得单独拿出来讲。SpringBoot 3.x 系列要求 JDK 17 及以上如果你自己的电脑装的是 JDK 8那直接创建 3.x 项目就会失败。市面上大量课程和源码还在使用 2.x 系列其中 2.5.x 到 2.7.x 是主流区间。我的建议是不要追新选 2.7.x。理由很简单2.7.x 既兼容 JDK 8 又兼容 JDK 11/17网上能找到的教程、依赖版本、问题解决方案最丰富。等到你对框架足够熟悉再回头升级到 3.x那时候踩的坑才是可控的。还有一个创建项目时常见的问题IDEA 里用默认的 start.spring.io 创建项目频繁超时解决办法是换成阿里云镜像地址https://start.aliyun.com。2.6 数据初始化与配置安全两个容易被忽视的点热词里提到的“springboot mybatis 当表不存在自动建表”和“springboot yml密文”虽然不属于这个项目的必备需求但很多人会在扩展功能或部署时碰到提前说两句。自动建表的实现方式有几种最简单的就是利用 SpringBoot 的spring.sql.init机制在classpath:下放一个schema.sql配置spring.sql.init.modealways应用启动时自动执行建表 SQL。注意如果使用 MySQL 并且在已有数据的情况下重启建议用CREATE TABLE IF NOT EXISTS语句避免覆盖数据。yml 密文则用 jasypt-spring-boot-starter将数据库密码等敏感信息加密后填入 yml配合 JVM 启动参数-Djasypt.encryptor.password密钥来解密。这个方案适合想让项目“更专业”的同学但对单机部署的毕设项目来说增加了配置复杂度属于锦上添花而非必需。3. 源码核心链路拆解一个游戏是怎么被“放”到网站里的拿到一份源码从哪里开始读我的建议是跟着一条数据流走从“管理员添加一个游戏”开始到“用户在前台看到并点开游玩”结束。这条链路走通了整个项目你就算吃透了六成。下面我用一个典型的 SpringBoot 分层结构来拆。3.1 工程分包结构与启动流程大多数合格的源码都遵循这个包结构com.example.gameweb ├── GamewebApplication.java // SpringBoot 启动类 ├── config/ // 配置类拦截器、静态资源映射、跨域 ├── controller/ // 控制层接收请求、返回页面或 JSON ├── service/ // 业务层核心业务逻辑 │ └── impl/ ├── mapper/ // 持久层接口继承 BaseMapper ├── entity/ // 数据库实体类 ├── vo/ // 视图对象封装页面需要的数据 └── common/ // 通用返回结果、异常处理、工具类启动类上通常会加MapperScan(com.example.gameweb.mapper)注解让 MyBatis-Plus 扫描到所有 Mapper 接口。有些写法是在每个 Mapper 接口上加Mapper注解两种方式等效。看源码时如果启动直接报“找不到Mapper”先检查这个注解有没有写对。3.2 数据库设计的核心表结构这类项目的表通常不多但字段设计的好坏直接影响代码复杂度和答辩观感。我见过不少源码把游戏封面和游戏文件的 URL 直接写死在页面里那是反面教材。合理的表结构应该类似于用户表t_user字段类型说明idbigint主键自增usernamevarchar(50)用户名唯一索引passwordvarchar(100)密码建议 BCrypt 加密存储nicknamevarchar(50)昵称avatarvarchar(255)头像地址create_timedatetime注册时间分类表t_category字段类型说明idbigint主键namevarchar(50)分类名称sortint排序权重游戏表t_game字段类型说明idbigint主键titlevarchar(100)游戏标题covervarchar(255)封面图地址game_urlvarchar(255)游戏文件地址或嵌入链接category_idbigint所属分类descriptiontext游戏简介play_countbigint点击/游玩次数enabletinyint是否上架0下架 1上架create_timedatetime添加时间收藏表t_favorite字段类型说明idbigint主键user_idbigint用户IDgame_idbigint游戏IDcreate_timedatetime收藏时间有个小细节需要注意密码字段的长度至少是 varchar(60) 或 varchar(100)因为 BCrypt 加密后的字符串长度是 60。很多学生图省事用 varchar(20)注册时密码一加密插入就直接报“Data too long for column”这就是典型的低级 bug。3.3 游戏文件的集成方式iframe 是核心但有边界游戏以什么形式“集成”进来是这个项目的技术核心。常见的就三种纯外部游戏链接game_url直接存一个https://xxx.com/game/xxx的外部地址游玩页 iframe 引用。实现最省事但联不上网的演示环境就废了。本地静态游戏文件把现成的 HTML5 小游戏整套文件放在src/main/resources/static/games/目录下game_url存相对路径如/games/snake/index.html。这个方案的优点是完全离线可用、部署后依然正常。我在自己的项目里就用的这种方式按游戏名建子目录前端页面干净又好管理。素材嵌入用canvas之类的技术自己实现游戏逻辑再集成。工作量和难度完全是另一个量级毕设不建议碰。关于 iframe 嵌入有个安全机制必须讲清楚如果游戏页面是外部站点对方设置了X-Frame-Options: DENY或者Content-Security-Policy: frame-ancestors你的页面是无法嵌入它的。所以选游戏素材的时候尽量优先选开源的、可本地化的 HTML5 游戏包别把命运交到别人服务器的响应头上。3.4 Controller 到页面渲染的一条完整链路我们以“用户点击某个游戏开始游玩”为例看一条完整的后端处理链路。首先游戏列表页向/game/list?categoryId1pageNum1pageSize8发起请求。对应的 GameController 方法是GetMapping(/list) public String gameList(RequestParam(required false) Long categoryId, RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 8) Integer pageSize, Model model) { // 构造查询条件 LambdaQueryWrapperGame wrapper new LambdaQueryWrapper(); if (categoryId ! null) { wrapper.eq(Game::getCategoryId, categoryId); } wrapper.eq(Game::getEnable, 1); wrapper.orderByDesc(Game::getPlayCount); PageGame page gameService.page(new Page(pageNum, pageSize), wrapper); model.addAttribute(gamePage, page); model.addAttribute(categories, categoryService.list()); return game/list; // 对应 templates/game/list.html }Controller 返回一个字符串game/listThymeleaf 就会去templates/game/list.html找模板并渲染。在模板里通过 Thymeleaf 语法拿到后台数据div classgame-card th:eachgame : ${gamePage.records} a th:href{/game/detail/ ${game.id}} img th:src${game.cover} alt封面 h3 th:text${game.title}游戏标题/h3 /a /div这里的{/game/detail/ ${game.id}}是 Thymeleaf 的链接表达式最终会渲染成/game/detail/3这种带路径参数的 URL。然后用户点击进入详情页此时会走/game/detail/{id}同时做两件事根据 ID 查询游戏信息给这个游戏的playCount字段加一。这里有个并发注意点不要在代码里先selectById再updateById做加一操作直接用数据库的原子操作UPDATE t_game SET play_count play_count 1 WHERE id ?MyBatis-Plus 里可以写自定义 SQL也可以在 XML 里实现。最后游玩页模板的 iframe 引入游戏文件iframe th:src${game.gameUrl} classgame-frame/iframe完整链路就是浏览器发起请求 → SpringBoot 处理查询 → Thymeleaf 渲染 HTML → 浏览器展示页面 → iframe 加载游戏文件。把这条链路搞清楚后面不管怎么改造思路都会非常清晰。4. 部署实战从本机跑到服务器最容易翻车的五个环节“源码能跑”和“放上服务器能跑”是两码事。部署文档写得薄学生在部署环节卡一整天是常事。这一节的教训来自我帮人看过的大量报错现场按从高到低的概率给你排个序。4.1 环境版本不匹配JDK、Maven、MySQL 三件套SpringBoot 2.7.x 要求 JDK 8 以上Maven 3.5 以上MySQL 5.7 或 8.x。看似简单但部署到服务器时经常出的问题是服务器上装的是 JDK 1.7 或者干脆没配JAVA_HOMEMaven 没装或版本过老MySQL 的认证插件与驱动版本不兼容。我的建议是部署文档的第一步必须写清“版本明细表”直接照抄执行。下面是我通常给出的环境版本组合软件推荐版本说明JDK1.8.0_202最后一个免费商用版本兼容性最好Maven3.6.3与 JDK8 搭配稳定MySQL5.7 或 8.05.7 轻量8.0 功能新注意驱动配置系统Ubuntu 20.04 / CentOS 7.x服务器最常见有一个很多人忽略的点本地 MySQL 是 8.0服务器是 5.7连接串里的driver-class-name写法不一样。MySQL 8.x 需要com.mysql.cj.jdbc.Driver而 5.7 用com.mysql.jdbc.Driver也能兼容。如果部署后报ClassNotFoundException: com.mysql.cj.jdbc.Driver说明你的 MySQL 驱动版本不对去 pom.xml 里看清楚你引的是哪个版本的 connector。4.2 数据库连接串时区、SSL、字符编码三连坑MySQL 8.x 时代连接串没写参数最容易报的就是 SSL 告警和时区错误。正确的连接地址应该长这样spring: datasource: url: jdbc:mysql://localhost:3306/gameweb?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver逐个解释下这些参数的作用useUnicodetruecharacterEncodingutf8保证中文字符在传输和存储过程中不乱码。useSSLfalse关闭 SSL 加密连接。本地和服务器内网通信没必要加密关闭后可避免大量告警日志和连接性能损耗。serverTimezoneAsia/Shanghai指定时区为北京时间。如果不设MySQL 8.x 默认 UTC 时间插入DATETIME类型字段时会差 8 小时。allowPublicKeyRetrievaltrueMySQL 8.x 使用 caching_sha2_password 认证时这个参数能避免Public Key Retrieval is not allowed的报错。说白了这个连接串几乎就是 MySQL 8 的标配不管部署到哪里直接复制改密码就对了。4.3 打包方式jar 与 war 的选择SpringBoot 项目默认打 jar 包我强烈建议坚持这个选择。java -jar gameweb.jar一条命令就能启动内置 Tomcat不依赖服务器上额外安装的 Tomcat。war 包则要先把 war 丢进外部 Tomcat 的 webapps 目录还要处理 Tomcat 版本和 Servlet 版本的适配。打包命令mvn clean package -DskipTests-DskipTests是跳过单元测试。不少项目的测试类里配了 Spring 上下文加载直接打包会因为连不上数据库而失败跳过测试是稳妥选择。打包成功后jar 文件出现在target/目录下。启动命令nohup java -jar gameweb.jar app.log 21 这是一个标准的 Unix 后台启动命令。解释一下nohup让程序在 SSH 断开后继续运行 app.log把标准输出和错误日志重定向到app.log文件21把错误输出合并到同一个日志文件最后的让命令在后台执行。查日志就tail -f app.log看启动是否成功。4.4 静态资源与端口占用两个看似诡异实则简单的报错有新手部署完访问http://服务器IP:8080发现页面能打开但封面图全是裂的控制台报 404。这种情况九成是静态资源路径没配对。SpringBoot 的默认静态资源目录是classpath:/static/你往static/games/snake/index.html放一个游戏文件访问路径应该是http://IP:8080/games/snake/index.html。如果项目配置了 context-path比如server.servlet.context-path/gameweb那么所有 URL 都要加上这个前缀。有些源码的静态资源用的是自定义路径映射比如把磁盘上的E:/upload/目录映射为/images/**这需要在配置类里写addResourceHandlers方法。所以部署后看到资源 404先去查配置文件里的路径相关项而不是盲目怀疑代码。端口被占用也是高频问题。Port 8080 was already in use这个报错一看就知道端口冲突。解决办法有两个方向一是找出占用端口的进程干掉它二是修改项目配置换一个端口。在application.yml里改server.port就行。如果换成了 80 端口URL 里就可以直接省略端口号展示效果更专业。4.5 数据库权限与导入姿势部署文档里最容易被忽略的细节服务器上的 MySQL 默认只允许 localhost 连接root 账号如果用了 auth_socket 插件用密码是连不上的。部署文档里务必写清楚数据库初始化步骤CREATE DATABASE gameweb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE gameweb; SOURCE /home/admin/gameweb.sql;同时确认账号权限GRANT ALL PRIVILEGES ON gameweb.* TO rootlocalhost IDENTIFIED BY 你的密码; FLUSH PRIVILEGES;utf8mb4 比 utf8 多支持 emoji 和一些生僻字游戏标题里偶尔会出现特殊符号所以建库字符集选 utf8mb4 比 utf8 更稳妥。5. 拿到“源码lw部署文档讲解”后怎么高效跑通并消化很多人花几百块买了一套“源码lw部署文档讲解视频”的资料包下载下来解压看到一堆文件瞬间就懵了。这一节我给出一个比较高效的学习路径分阶段来稳扎稳打。5.1 阶段一两小时极限跑通别急着看代码第一遍的目的只有一个让项目在你电脑上运行起来。这个过程不需要理解任何代码逻辑照做就行。按顺序做四件事检查环境JDK 版本、Maven 版本、MySQL 版本是否和部署文档一致不匹配先解决。执行 SQL把项目里提供的/sql/init.sql或者gameweb.sql导入本地 MySQL建库建表、写入初始数据都在这一个文件里。改配置打开application.yml改数据库账号密码确认端口号没被占用。启动访问IDE 里直接运行启动类等日志出现Started GamewebApplication后浏览器访问http://localhost:8080。这里特别提醒如果启动时报Failed to configure a DataSource不要慌十有八九是配置没生效检查application.yml的文件名是否正确、是否在src/main/resources目录下、配置里的缩进是否规范。YAML 对缩进是敏感的一个 Tab 缩进不对整份配置就会崩掉。5.2 阶段二代码阅读顺序从入口到数据层完整过一遍跑通之后开始读代码不要从头看到尾而是按下面这个顺序启动类看注解理解自动装配的源头。配置类看拦截器注册了哪些路径、静态资源映射了哪些目录。Controller把所有 URL 和对应的视图或 JSON 结构列出来形成一个“路由地图”。Service关注事务注解Transactional的使用位置以及核心业务方法的实现。Mapper/XML看复杂查询 SQL 的编写方式。模板引擎页面对照 Controller 里 Model 的字段理解页面如何展示。读源码时准备一个笔记软件把每个请求的“URL → Controller 方法 → Service 方法 → SQL 语句 → 返回页面/JSON ”按链路梳理出来。当你完成 3 到 4 条这样的链路记录这个项目在你眼里就没有秘密了。5.3 阶段三二次开发把别人的项目变成“你的毕设”答辩最怕的是导师问“这个功能是怎么实现的”你回答“这是源码里带的”。所以拿到源码后做适度的二次开发是很有必要的安全垫。改造成本低、答辩效果好的方向有几个美化前端游戏列表页的卡片样式、轮播图、页脚信息这些改动纯前端工作量但肉眼可见地“焕然一新”。增加热门游戏榜单在首页加一个“点击榜 TOP10”SQL 一条ORDER BY play_count DESC LIMIT 10就搞定。增加个人中心收藏功能如果源码里没有收藏功能自己加一张 t_favorite 表实现收藏、取消收藏、我的收藏列表三个功能点工作量适中但完整覆盖了“用户关联数据”这一经典考点。增加评论功能游戏详情页下方加评论列表和发表评论框需要一张评论表和用户关联查询也是课设的高频加分项。二次开发的核心原则是“小而完整”。宁可只加一个从页面到数据库闭环的功能也不要蜻蜓点水地在十个地方改十几个字段。答辩老师的注意力是有限的一个讲得清楚、代码经得起追问、数据流转完整的亮点功能胜过十个杂而不精的“补丁”。5.4 关于“lw”和“讲解视频”的正确使用资料包里的 lw 通常是论文章节草稿或完整论文讲解视频一般是对源码的分模块讲解。这两份东西的使用建议是论文提供的是“怎么说”。你对照着论文里的系统设计章节能快速了解每个模块的设计意图但不要直接照抄。抄袭查重不过关的后果不用我多说。视频提供的是“怎么跑”。先按视频的演示操作一遍然后合上视频自己独立操作一遍卡住的地方再打开视频对应片段。这一遍独立操作能暴露所有你还没掌握的细节。6. 常见启动与运行报错排查手册这一节整理我在实践过程中遇到的、以及帮别人排查时最常出现的报错按错误信息、原因、解决方案三个维度整理成表格。建议收藏部署时遇到问题直接对照速查。报错信息/现象根本原因解决方案Port 8080 was already in use8080 端口被占用换端口或lsof -i:8080查杀占用进程Failed to configure a DataSource数据源配置缺失/错误检查application.yml的 url、username、password确认驱动存在Public Key Retrieval is not allowedMySQL 8 的 caching_sha2_password 认证连接串加allowPublicKeyRetrievaltrueUnknown database gameweb数据库未创建执行CREATE DATABASE gameweb DEFAULT CHARACTER SET utf8mb4Data too long for column password密码字段长度不足BCrypt 加密串超长将 password 字段改为 varchar(100)页面打开但图片/游戏 404静态资源路径映射不对检查static目录结构和 spring.mvc.static-path-pattern中文乱码字符集不一致连接串加characterEncodingutf8数据库建库用 utf8mb4启动成功但访问 404context-path 配置导致 URL 前缀变化检查server.servlet.context-path按带前缀的路径访问java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver驱动版本与 MySQL 版本不匹配更新 mysql-connector-j 依赖版本Session 值存了但取不到方法间会话使用不当确认存入与取出使用相同的 session key确认拦截器未把请求拦掉部署后nohup启动失败查看日志为空权限不足或 java 命令不在 PATH 中使用绝对路径启动/usr/local/jdk1.8.0_202/bin/java -jar最后再分享一个值得养成的习惯项目部署到服务器之前先在自己电脑上把数据库备份文件导出并测试一遍导入流程。很多项目在本地能跑是因为本地数据库里手动添加了很多测试数据而备份文件残缺导致全新环境跑不起来。把“从零环境按文档跑通”作为验收标准这类项目就稳了。做这行越久越会发现真正决定一个项目能不能交付的往往不是那些炫酷的代码而是这些不起眼的工程细节。