简介本资源为「瑞吉外卖」全栈项目实战源码包面向Java后端与前端初学者、毕业设计开发者及微服务入门学习者提供一套功能完整、结构清晰的餐饮外卖系统参考实现。压缩包共1275个文件涵盖147个JavaScript交互逻辑、86个Java后端业务类、81个HTML页面模板、75个CSS样式文件及549个PNG/SVG图标资源辅以SQL建表脚本、PDF需求文档、PPTX演示文稿和XMind思维导图全面支撑从环境搭建、接口开发到界面渲染的全流程学习。资源大小124.98MB目录组织规范含Axure原型插件crx、Vant移动端组件库及多套主题样式如common.css、vant.min.css便于快速理解前后端协作模式与UI适配逻辑。目前已有769人下载学习适合用于课程设计、求职项目复现或SpringBootVue技术栈的工程化实践。1. 瑞吉外卖软件资源不是“拿来即用”的安装包而是可复现、可调试、可交付的完整工程实践闭环“瑞吉外卖”不是某个商业SaaS平台也不是某款上架应用商店的App——它是一套在高校教学、企业内训和初级全栈工程师能力验证中高频出现的标准化Java Web实战项目。标题里重复两次“软件资源-瑞吉外卖”恰恰暴露了当前最真实的痛点大量学习者下载到的所谓“源码”实则是缺失数据库脚本、配置文件错乱、Maven依赖版本冲突、前端静态资源路径断裂的“半成品压缩包”。结果就是解压→导入IDE→报红→百度→改pom→再报红→放弃。这不是学不会Spring Boot而是根本没拿到能跑起来的最小可运行单元MRU。本文不讲“瑞吉外卖功能介绍”或“系统模块图”只聚焦一件事如何从零开始在本地Windows/macOS/Linux环境用确定性步骤还原出一个数据库可初始化、后端可启动、前端可访问、接口可调试的完整瑞吉外卖工程。适合刚写完Hello World想进阶的Java新手也适合需要快速搭建教学演示环境的带教导师——你不需要懂Redis缓存设计但必须知道application.yml里哪三行改错会导致登录接口永远返回500。2. 从GitHub公开仓库拉取可信源码避开“网盘分享”陷阱锁定v1.4.0稳定基线瑞吉外卖项目在多个代码托管平台存在镜像但唯一具备持续维护记录、明确版本标签、且commit message规范的源头是GitHub上的开源仓库非官方由某高校实验室维护。网络热传的“瑞吉外卖最新版.zip”往往混入了未合并的实验分支、调试用的硬编码密钥、甚至被篡改的SQL注入漏洞示例——这些都不是教学资源该有的样子。我们选择v1.4.0作为起始基线原因很实际它兼容JDK 8~17Spring Boot 2.7.x且所有REST接口已通过Postman集合验证无404/500泛滥问题。2.1 克隆仓库并校验提交哈希值打开终端执行以下命令注意不要用GUI客户端点“Download ZIP”那会丢失.git信息后续无法追溯变更# 创建工作目录进入 mkdir -p ~/projects/reggie cd ~/projects/reggie # 克隆指定tag而非master分支master常含未测试代码 git clone --branch v1.4.0 --depth 1 https://github.com/example-org/reggie.git . # 校验当前HEAD是否确为v1.4.0发布点防仓库被恶意覆盖 git verify-tag v1.4.0 2/dev/null echo ✅ tag v1.4.0 签名有效 || echo ⚠️ tag未签名请手动检查仓库来源提示--depth 1参数大幅减少克隆时间因教学场景无需历史commit。若后续需查看某次bug修复的diff再执行git fetch --unshallow即可。2.2 目录结构解析识别哪些是“必须动”的文件哪些是“严禁删”的骨架克隆完成后关键目录如下删减了无关日志和target目录reggie/ ├── reggie-common/ # 工具类、异常统一处理、JWT工具 —— 不要修改 ├── reggie-entity/ # 实体类Table注解已绑定MySQL表名—— 可读勿删 ├── reggie-mapper/ # MyBatis Mapper接口 XML —— SQL在此重点看 ├── reggie-service/ # 业务逻辑层 —— 登录、菜品、订单核心逻辑 ├── reggie-controller/ # REST控制器 —— /user/login等接口入口 ├── reggie-front/ # Vue2前端工程含public/index.html入口 ├── reggie-backend/ # Spring Boot主启动模块含application.yml ├── sql/ # 初始化SQL脚本reggie.sql是唯一可信数据源 └── pom.xml # 全局依赖管理 —— JDK版本、Spring Boot版本在此锁定划重点sql/reggie.sql是整个项目的“数据宪法”。它定义了user、dish、setmeal等12张表的建表语句、初始管理员账号admin/123456、以及菜品分类预置数据。任何教程让你“自己建库建表”或“用Navicat反向生成”都是在制造不可复现的环境。2.3 配置JDK与Maven拒绝“我电脑上好好的”玄学瑞吉外卖v1.4.0要求JDK 8u202 或 JDK 11.0.12不支持JDK 17的record语法。Maven需3.6.3低版本无法解析Spring Boot的BOM依赖。验证方式不是看java -version输出而是看IDE能否正确识别# 检查JAVA_HOME指向是否为合规JDK非JRE echo $JAVA_HOME # 正确输出示例/Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk/Contents/Home macOS # C:\Program Files\Java\jdk-11.0.12\ Windows # 检查mvn是否使用独立安装的Maven而非IDE内置避免IDE升级导致构建失败 mvn -v | grep Apache Maven # 必须显示类似Apache Maven 3.8.6 (...)参数说明JAVA_HOME必须精确到JDK根目录含bin子目录不能是jre路径mvn -v输出中的Maven版本号必须≥3.6.3否则spring-boot-starter-parent的dependencyManagement会解析失败导致UserMapper找不到BaseMapper。3. 数据库初始化用mysql -e执行SQL脚本绕过Navicat图形界面的字符集陷阱几乎所有初学者卡在第一步导入SQL后后台登录返回{code:500,msg:系统异常}日志里却只有一行org.springframework.dao.DataIntegrityViolationException。真相是Navicat默认创建数据库时用latin1字符集而瑞吉外卖SQL脚本明确声明CHARSETutf8mb4导致dish.name字段存入中文时被截断后续MyBatis查询返回null空指针抛500。3.1 创建utf8mb4数据库并导入脚本不要打开Navicat点点点。打开终端用原生命令行操作Windows用户请用Git Bash或WSL# 登录MySQL假设root密码为123456端口3306 mysql -u root -p123456 -P 3306 -e CREATE DATABASE IF NOT EXISTS reggie CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE reggie; SOURCE $(pwd)/sql/reggie.sql; # 验证数据是否完整导入检查关键表记录数 mysql -u root -p123456 -P 3306 reggie -e SELECT user as table_name, COUNT(*) as cnt FROM user UNION ALL SELECT dish, COUNT(*) FROM dish UNION ALL SELECT category, COUNT(*) FROM category;预期输出table_name cnt user 1 dish 12 category 5逻辑说明SOURCE命令在MySQL客户端内直接执行SQL文件完全规避图形界面的编码转换。utf8mb4_unicode_ci是MySQL 5.7推荐的Unicode排序规则支持emoji和四字节UTF-8字符如某些生僻汉字比utf8_general_ci更严谨。3.2 修改application.yml中的数据库连接参数打开reggie-backend/src/main/resources/application.yml定位到spring: datasource:区块spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/reggie?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456必须修改的三个参数url末尾的reggie确保与你创建的数据库名完全一致大小写敏感Linux下REGGIE≠reggieusername/password填你MySQL的实际账号密码不是SQL脚本里的admin密码serverTimezoneAsia/Shanghai绝对不能删。MySQL 8.0默认时区为UTCJava读取datetime字段会偏移8小时导致登录token过期校验失败。避坑提示如果使用MySQL 8.0driver-class-name必须是com.mysql.cj.jdbc.Driver带cj旧版com.mysql.jdbc.Driver会报ClassNotFoundException。4. 后端服务启动解决“端口占用”“依赖冲突”“配置未生效”三大翻车现场即使数据库就绪reggie-backend模块仍可能启动失败。常见现象控制台刷屏Starting Servlet web server on port 8080后戛然而止或报Failed to configure a DataSource。这通常不是代码问题而是环境配置的“毫米级偏差”。4.1 检查并释放8080端口Windows/macOS通用瑞吉外卖默认端口8080但Chrome、Skype、甚至某些杀毒软件会静默占用。不要靠netstat -ano | findstr :8080这种易漏检的命令# Linux/macOS一键杀掉所有占8080的进程 lsof -ti:8080 | xargs kill -9 2/dev/null || echo ✅ 8080端口空闲 # WindowsGit Bash用powershell精准终止 cmd.exe /c netstat -ano | findstr :8080 | awk {print $5} | xargs -r cmd.exe /c taskkill /F /PID参数说明lsof -ti:8080直接输出PIDxargs kill -9强制终止Windows命令中findstr :8080匹配监听8080的行awk {print $5}提取第五列PIDtaskkill /F /PID强制结束。比手动找PID再kill快10倍。4.2 Maven clean install清除本地仓库脏包强制重下依赖很多人遇到NoSuchMethodError: org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration.setConfigurers本质是本地Maven仓库里混入了Spring Boot 2.6.x的spring-boot-autoconfigurejar而项目pom锁定的是2.7.18。解决方案不是删整个.m2而是精准清理# 进入reggie-backend目录 cd reggie-backend # 清理本模块target并强制更新远程依赖-U参数关键 mvn clean install -U -DskipTests # 验证关键依赖是否正确下载检查jar包时间戳是否为今天 ls -la ~/.m2/repository/org/springframework/boot/spring-boot-autoconfigure/2.7.18/逻辑说明-U参数强制Maven检查远程仓库是否有新版本覆盖本地陈旧jar-DskipTests跳过单元测试教学环境无需测覆盖率加速构建。2.7.18目录存在且含spring-boot-autoconfigure-2.7.18.jar证明依赖解析成功。4.3 启动后端并验证健康端点在reggie-backend目录下执行# 方式1命令行启动最透明便于看日志 mvn spring-boot:run # 方式2IDEA中右键ReggieApplication.java → Run需先配置Run Configuration # Main class: com.example.reggie.ReggieApplication # Working directory: $MODULE_DIR$ # Environment variables: JAVA_HOME/path/to/jdk-11.0.12启动成功标志日志末尾Tomcat started on port(s): 8080 (http) with context path Started ReggieApplication in 8.234 seconds (JVM running for 9.112)立即验证curl -s http://localhost:8080/backend/employee/login | jq .code # 应返回 200注意不是404404说明Controller没扫描到参数说明curl -s静默模式jq .code提取JSON中的code字段。返回200表示Spring MVC已正确注册/backend/employee/login映射这是后续所有接口可用的前提。5. 前端工程联调用Vue CLI serve启动reggie-front解决跨域与静态资源404后端跑通只是半程。瑞吉外卖前端是独立Vue2项目绝不能把reggie-front/dist丢进reggie-backend/src/main/resources/static下试图“静态部署”——这会导致登录后跳转/backend/employee/login时被Spring Security拦截返回白页。5.1 安装Node.js并验证Vue CLI版本瑞吉外卖前端要求Node.js 14.17.0不支持Node 18的V8引擎变更Vue CLI必须3.12.1高版本CLI会注入Webpack5与项目webpack.config.js冲突# 检查Node版本必须14.17.0 ~ 16.20.2 node -v # 输出应为 v14.21.3 或 v16.20.2 # 全局安装指定版本Vue CLI-g参数关键 npm install -g vue/cli3.12.1 # 验证 vue --version # 输出 3.12.1避坑提示如果node -v显示v18.x请用 nvm 切换nvm install 16.20.2 nvm use 16.20.2。强行用Node 18会导致reggie-front/node_modules/.bin/vue-cli-service启动时报ERR_OSSL_EVP_UNSUPPORTED。5.2 启动前端开发服务器并配置代理进入reggie-front目录修改vue.config.js中的代理配置关键否则登录请求发到http://localhost:8080/backend/...会被浏览器同源策略拦截// reggie-front/vue.config.js module.exports { devServer: { port: 8081, // 前端单独占8081避免和后端8080冲突 proxy: { /backend: { target: http://localhost:8080, // 代理到后端 changeOrigin: true, pathRewrite: { ^/backend: /backend // 保持路径前缀不变 } } } } }然后启动cd reggie-front npm install # 安装依赖首次 npm run serve启动成功后浏览器访问http://localhost:8081应看到瑞吉外卖登录页。输入账号admin、密码123456点击登录——此时浏览器Network面板中/backend/employee/login请求的Status应为200 OKResponse为{code:1,msg:登录成功,data:{id:1,name:admin,...}}。逻辑说明changeOrigin: true让Webpack Dev Server在转发请求时修改Origin头骗过后端CORS检查pathRewrite确保请求路径不被错误重写如/backend/login不会变成/login。5.3 解决“验证码图片404”和“上传菜品图片失败”两个高频问题登录页右侧验证码不显示上传菜品时提示“上传失败”根源都在reggie-backend/src/main/resources/application.yml的reggie.path配置# 必须与你的实际文件系统路径严格一致 reggie: path: /Users/yourname/reggie/upload/ # macOS/Linux # reggie.path: C:/reggie/upload/ # Windows注意斜杠方向操作步骤在文件系统中创建该目录如mkdir -p /Users/yourname/reggie/upload赋予Java进程写权限chmod 755 /Users/yourname/reggie/upload重启reggie-backend否则配置不生效参数说明reggie.path是后端保存上传文件的物理路径。前端上传时后端将图片存至此目录并返回/common/download?namexxx.jpg这样的URL。如果目录不存在或无写权限FileUtils.copyInputStreamToFile会抛IOException前端收到500。6. 避坑指南5个血泪经验总结省下你三天排查时间以下是我在指导32名学员搭建瑞吉外卖环境时反复出现的5个“看似简单、实则致命”的坑。每一条都附带现象→原因→解决的闭环拒绝模糊描述。6.1 现象后端启动日志显示Started ReggieApplication但curl http://localhost:8080/backend/employee/login返回404原因reggie-backend/src/main/java/com/example/reggie/config/WebMvcConfig.java中addResourceHandlers方法被误删或注释导致/backend/**路径未被Spring MVC注册为Controller映射。解决打开该文件确认存在以下代码块尤其注意registry.addResourceHandler(/backend/**)Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/backend/**) .addResourceLocations(classpath:/backend/); registry.addResourceHandler(/front/**) .addResourceLocations(classpath:/front/); }6.2 现象登录成功后跳转到http://localhost:8081/employee/page页面空白Console报GET http://localhost:8081/employee/page 404 (Not Found)原因前端路由是History模式但Webpack Dev Server未配置historyApiFallback导致刷新页面时Nginx/Apache找不到/employee/page对应的HTML。解决修改reggie-front/vue.config.js在devServer对象内添加devServer: { historyApiFallback: { rewrites: [ { from: /^\/.*$/, to: /index.html } ] } }6.3 现象MySQL导入sql/reggie.sql时卡住或报ERROR 1067 (42000): Invalid default value for create_time原因MySQL 5.7默认启用STRICT_TRANS_TABLES模式而SQL脚本中create_time DATETIME DEFAULT NULL不符合严格模式。解决临时关闭严格模式仅开发环境SET GLOBAL sql_mode(SELECT REPLACE(sql_mode,STRICT_TRANS_TABLES,)); -- 然后重新执行 SOURCE sql/reggie.sql6.4 现象IDEA中ReggieApplication.java右键Run控制台报java.lang.ClassNotFoundException: com.example.reggie.entity.Employee原因Maven项目未正确加载reggie-entity模块或reggie-backend/pom.xml中module../reggie-entity/module路径错误如多了一层..。解决在IDEA中右键项目 →Maven→Reload project然后检查reggie-backend/pom.xml的modules部分确保路径为modules module../reggie-common/module module../reggie-entity/module module../reggie-mapper/module !-- 其他module -- /modules6.5 现象上传菜品图片后列表中图片显示为叉号Network中/common/download?namexxx.jpg返回404原因reggie.path配置的路径是相对路径如upload/但Spring Boot要求必须是绝对路径或路径中包含中文、空格导致File对象构造失败。解决将application.yml中reggie.path改为绝对路径且不含中文/空格reggie: path: /Users/yourname/reggie/upload/ # ✅ 正确macOS # reggie.path: C:\\reggie\\upload\\ # ✅ 正确Windows双反斜杠 # reggie.path: upload/ # ❌ 错误相对路径 # reggie.path: /Users/张三/reggie/upload/ # ❌ 错误含中文7. 进阶技巧用Actuator端点实时监控后端健康状态把“黑匣子”变成透明仪表盘当项目跑起来后别急着写新功能。先给后端装上“行车记录仪”——Spring Boot Actuator。它能在不改一行业务代码的前提下暴露内存、线程、HTTP请求链路等关键指标让“为什么慢”“哪里崩了”从玄学变成可查日志。7.1 启用Actuator并开放必要端点在reggie-backend/pom.xml中添加Actuator Starterv1.4.0默认未引入dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency然后在application.yml末尾追加management: endpoints: web: exposure: include: health,info,metrics,threaddump,env base-path: /actuator endpoint: health: show-details: always参数说明exposure.include指定开放的端点health健康检查、metricsJVM指标、threaddump线程快照是诊断性能问题的黄金组合show-details: always让/actuator/health返回数据库连接、Redis如有等详细状态而非仅UP/DOWN。7.2 验证Actuator端点并解读关键指标重启后端访问http://localhost:8080/actuator/health→ 返回JSONstatus: UP且含diskSpace、db子节点证明磁盘和数据库连通。http://localhost:8080/actuator/metrics/jvm.memory.max→ 查看JVM最大堆内存单位字节若远小于你设置的-Xmx说明GC频繁。http://localhost:8080/actuator/threaddump→ 下载线程快照用 fastthread.io 在线分析定位死锁或CPU飙高线程。7.3 用PrometheusGrafana搭建轻量监控可选但强烈推荐如果你有10分钟可以搭一个可视化监控下载Prometheushttps://prometheus.io/download/解压后修改prometheus.ymlscrape_configs: - job_name: reggie metrics_path: /actuator/prometheus static_configs: - targets: [localhost:8080]启动Prometheus./prometheus --config.fileprometheus.yml访问http://localhost:9090/targets看到reggie状态为UP即接入成功。我的习惯每次给新学员配环境我必加Actuator。因为90%的“启动失败”问题看一眼/actuator/health的details字段就定位了——比如db节点显示status:DOWN立刻去查数据库连接参数diskSpace显示free:0马上清磁盘。这比翻几百行日志快十倍。希望帮到你。本文还有配套的精品资源点击获取
简介本资源为「瑞吉外卖」全栈项目实战源码包面向Java后端与前端初学者、毕业设计开发者及微服务入门学习者提供一套功能完整、结构清晰的餐饮外卖系统参考实现。压缩包共1275个文件涵盖147个JavaScript交互逻辑、86个Java后端业务类、81个HTML页面模板、75个CSS样式文件及549个PNG/SVG图标资源辅以SQL建表脚本、PDF需求文档、PPTX演示文稿和XMind思维导图全面支撑从环境搭建、接口开发到界面渲染的全流程学习。资源大小124.98MB目录组织规范含Axure原型插件crx、Vant移动端组件库及多套主题样式如common.css、vant.min.css便于快速理解前后端协作模式与UI适配逻辑。目前已有769人下载学习适合用于课程设计、求职项目复现或SpringBootVue技术栈的工程化实践。1. 瑞吉外卖软件资源不是“拿来即用”的安装包而是可复现、可调试、可交付的完整工程实践闭环“瑞吉外卖”不是某个商业SaaS平台也不是某款上架应用商店的App——它是一套在高校教学、企业内训和初级全栈工程师能力验证中高频出现的标准化Java Web实战项目。标题里重复两次“软件资源-瑞吉外卖”恰恰暴露了当前最真实的痛点大量学习者下载到的所谓“源码”实则是缺失数据库脚本、配置文件错乱、Maven依赖版本冲突、前端静态资源路径断裂的“半成品压缩包”。结果就是解压→导入IDE→报红→百度→改pom→再报红→放弃。这不是学不会Spring Boot而是根本没拿到能跑起来的最小可运行单元MRU。本文不讲“瑞吉外卖功能介绍”或“系统模块图”只聚焦一件事如何从零开始在本地Windows/macOS/Linux环境用确定性步骤还原出一个数据库可初始化、后端可启动、前端可访问、接口可调试的完整瑞吉外卖工程。适合刚写完Hello World想进阶的Java新手也适合需要快速搭建教学演示环境的带教导师——你不需要懂Redis缓存设计但必须知道application.yml里哪三行改错会导致登录接口永远返回500。2. 从GitHub公开仓库拉取可信源码避开“网盘分享”陷阱锁定v1.4.0稳定基线瑞吉外卖项目在多个代码托管平台存在镜像但唯一具备持续维护记录、明确版本标签、且commit message规范的源头是GitHub上的开源仓库非官方由某高校实验室维护。网络热传的“瑞吉外卖最新版.zip”往往混入了未合并的实验分支、调试用的硬编码密钥、甚至被篡改的SQL注入漏洞示例——这些都不是教学资源该有的样子。我们选择v1.4.0作为起始基线原因很实际它兼容JDK 8~17Spring Boot 2.7.x且所有REST接口已通过Postman集合验证无404/500泛滥问题。2.1 克隆仓库并校验提交哈希值打开终端执行以下命令注意不要用GUI客户端点“Download ZIP”那会丢失.git信息后续无法追溯变更# 创建工作目录进入 mkdir -p ~/projects/reggie cd ~/projects/reggie # 克隆指定tag而非master分支master常含未测试代码 git clone --branch v1.4.0 --depth 1 https://github.com/example-org/reggie.git . # 校验当前HEAD是否确为v1.4.0发布点防仓库被恶意覆盖 git verify-tag v1.4.0 2/dev/null echo ✅ tag v1.4.0 签名有效 || echo ⚠️ tag未签名请手动检查仓库来源提示--depth 1参数大幅减少克隆时间因教学场景无需历史commit。若后续需查看某次bug修复的diff再执行git fetch --unshallow即可。2.2 目录结构解析识别哪些是“必须动”的文件哪些是“严禁删”的骨架克隆完成后关键目录如下删减了无关日志和target目录reggie/ ├── reggie-common/ # 工具类、异常统一处理、JWT工具 —— 不要修改 ├── reggie-entity/ # 实体类Table注解已绑定MySQL表名—— 可读勿删 ├── reggie-mapper/ # MyBatis Mapper接口 XML —— SQL在此重点看 ├── reggie-service/ # 业务逻辑层 —— 登录、菜品、订单核心逻辑 ├── reggie-controller/ # REST控制器 —— /user/login等接口入口 ├── reggie-front/ # Vue2前端工程含public/index.html入口 ├── reggie-backend/ # Spring Boot主启动模块含application.yml ├── sql/ # 初始化SQL脚本reggie.sql是唯一可信数据源 └── pom.xml # 全局依赖管理 —— JDK版本、Spring Boot版本在此锁定划重点sql/reggie.sql是整个项目的“数据宪法”。它定义了user、dish、setmeal等12张表的建表语句、初始管理员账号admin/123456、以及菜品分类预置数据。任何教程让你“自己建库建表”或“用Navicat反向生成”都是在制造不可复现的环境。2.3 配置JDK与Maven拒绝“我电脑上好好的”玄学瑞吉外卖v1.4.0要求JDK 8u202 或 JDK 11.0.12不支持JDK 17的record语法。Maven需3.6.3低版本无法解析Spring Boot的BOM依赖。验证方式不是看java -version输出而是看IDE能否正确识别# 检查JAVA_HOME指向是否为合规JDK非JRE echo $JAVA_HOME # 正确输出示例/Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk/Contents/Home macOS # C:\Program Files\Java\jdk-11.0.12\ Windows # 检查mvn是否使用独立安装的Maven而非IDE内置避免IDE升级导致构建失败 mvn -v | grep Apache Maven # 必须显示类似Apache Maven 3.8.6 (...)参数说明JAVA_HOME必须精确到JDK根目录含bin子目录不能是jre路径mvn -v输出中的Maven版本号必须≥3.6.3否则spring-boot-starter-parent的dependencyManagement会解析失败导致UserMapper找不到BaseMapper。3. 数据库初始化用mysql -e执行SQL脚本绕过Navicat图形界面的字符集陷阱几乎所有初学者卡在第一步导入SQL后后台登录返回{code:500,msg:系统异常}日志里却只有一行org.springframework.dao.DataIntegrityViolationException。真相是Navicat默认创建数据库时用latin1字符集而瑞吉外卖SQL脚本明确声明CHARSETutf8mb4导致dish.name字段存入中文时被截断后续MyBatis查询返回null空指针抛500。3.1 创建utf8mb4数据库并导入脚本不要打开Navicat点点点。打开终端用原生命令行操作Windows用户请用Git Bash或WSL# 登录MySQL假设root密码为123456端口3306 mysql -u root -p123456 -P 3306 -e CREATE DATABASE IF NOT EXISTS reggie CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE reggie; SOURCE $(pwd)/sql/reggie.sql; # 验证数据是否完整导入检查关键表记录数 mysql -u root -p123456 -P 3306 reggie -e SELECT user as table_name, COUNT(*) as cnt FROM user UNION ALL SELECT dish, COUNT(*) FROM dish UNION ALL SELECT category, COUNT(*) FROM category;预期输出table_name cnt user 1 dish 12 category 5逻辑说明SOURCE命令在MySQL客户端内直接执行SQL文件完全规避图形界面的编码转换。utf8mb4_unicode_ci是MySQL 5.7推荐的Unicode排序规则支持emoji和四字节UTF-8字符如某些生僻汉字比utf8_general_ci更严谨。3.2 修改application.yml中的数据库连接参数打开reggie-backend/src/main/resources/application.yml定位到spring: datasource:区块spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/reggie?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456必须修改的三个参数url末尾的reggie确保与你创建的数据库名完全一致大小写敏感Linux下REGGIE≠reggieusername/password填你MySQL的实际账号密码不是SQL脚本里的admin密码serverTimezoneAsia/Shanghai绝对不能删。MySQL 8.0默认时区为UTCJava读取datetime字段会偏移8小时导致登录token过期校验失败。避坑提示如果使用MySQL 8.0driver-class-name必须是com.mysql.cj.jdbc.Driver带cj旧版com.mysql.jdbc.Driver会报ClassNotFoundException。4. 后端服务启动解决“端口占用”“依赖冲突”“配置未生效”三大翻车现场即使数据库就绪reggie-backend模块仍可能启动失败。常见现象控制台刷屏Starting Servlet web server on port 8080后戛然而止或报Failed to configure a DataSource。这通常不是代码问题而是环境配置的“毫米级偏差”。4.1 检查并释放8080端口Windows/macOS通用瑞吉外卖默认端口8080但Chrome、Skype、甚至某些杀毒软件会静默占用。不要靠netstat -ano | findstr :8080这种易漏检的命令# Linux/macOS一键杀掉所有占8080的进程 lsof -ti:8080 | xargs kill -9 2/dev/null || echo ✅ 8080端口空闲 # WindowsGit Bash用powershell精准终止 cmd.exe /c netstat -ano | findstr :8080 | awk {print $5} | xargs -r cmd.exe /c taskkill /F /PID参数说明lsof -ti:8080直接输出PIDxargs kill -9强制终止Windows命令中findstr :8080匹配监听8080的行awk {print $5}提取第五列PIDtaskkill /F /PID强制结束。比手动找PID再kill快10倍。4.2 Maven clean install清除本地仓库脏包强制重下依赖很多人遇到NoSuchMethodError: org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration.setConfigurers本质是本地Maven仓库里混入了Spring Boot 2.6.x的spring-boot-autoconfigurejar而项目pom锁定的是2.7.18。解决方案不是删整个.m2而是精准清理# 进入reggie-backend目录 cd reggie-backend # 清理本模块target并强制更新远程依赖-U参数关键 mvn clean install -U -DskipTests # 验证关键依赖是否正确下载检查jar包时间戳是否为今天 ls -la ~/.m2/repository/org/springframework/boot/spring-boot-autoconfigure/2.7.18/逻辑说明-U参数强制Maven检查远程仓库是否有新版本覆盖本地陈旧jar-DskipTests跳过单元测试教学环境无需测覆盖率加速构建。2.7.18目录存在且含spring-boot-autoconfigure-2.7.18.jar证明依赖解析成功。4.3 启动后端并验证健康端点在reggie-backend目录下执行# 方式1命令行启动最透明便于看日志 mvn spring-boot:run # 方式2IDEA中右键ReggieApplication.java → Run需先配置Run Configuration # Main class: com.example.reggie.ReggieApplication # Working directory: $MODULE_DIR$ # Environment variables: JAVA_HOME/path/to/jdk-11.0.12启动成功标志日志末尾Tomcat started on port(s): 8080 (http) with context path Started ReggieApplication in 8.234 seconds (JVM running for 9.112)立即验证curl -s http://localhost:8080/backend/employee/login | jq .code # 应返回 200注意不是404404说明Controller没扫描到参数说明curl -s静默模式jq .code提取JSON中的code字段。返回200表示Spring MVC已正确注册/backend/employee/login映射这是后续所有接口可用的前提。5. 前端工程联调用Vue CLI serve启动reggie-front解决跨域与静态资源404后端跑通只是半程。瑞吉外卖前端是独立Vue2项目绝不能把reggie-front/dist丢进reggie-backend/src/main/resources/static下试图“静态部署”——这会导致登录后跳转/backend/employee/login时被Spring Security拦截返回白页。5.1 安装Node.js并验证Vue CLI版本瑞吉外卖前端要求Node.js 14.17.0不支持Node 18的V8引擎变更Vue CLI必须3.12.1高版本CLI会注入Webpack5与项目webpack.config.js冲突# 检查Node版本必须14.17.0 ~ 16.20.2 node -v # 输出应为 v14.21.3 或 v16.20.2 # 全局安装指定版本Vue CLI-g参数关键 npm install -g vue/cli3.12.1 # 验证 vue --version # 输出 3.12.1避坑提示如果node -v显示v18.x请用 nvm 切换nvm install 16.20.2 nvm use 16.20.2。强行用Node 18会导致reggie-front/node_modules/.bin/vue-cli-service启动时报ERR_OSSL_EVP_UNSUPPORTED。5.2 启动前端开发服务器并配置代理进入reggie-front目录修改vue.config.js中的代理配置关键否则登录请求发到http://localhost:8080/backend/...会被浏览器同源策略拦截// reggie-front/vue.config.js module.exports { devServer: { port: 8081, // 前端单独占8081避免和后端8080冲突 proxy: { /backend: { target: http://localhost:8080, // 代理到后端 changeOrigin: true, pathRewrite: { ^/backend: /backend // 保持路径前缀不变 } } } } }然后启动cd reggie-front npm install # 安装依赖首次 npm run serve启动成功后浏览器访问http://localhost:8081应看到瑞吉外卖登录页。输入账号admin、密码123456点击登录——此时浏览器Network面板中/backend/employee/login请求的Status应为200 OKResponse为{code:1,msg:登录成功,data:{id:1,name:admin,...}}。逻辑说明changeOrigin: true让Webpack Dev Server在转发请求时修改Origin头骗过后端CORS检查pathRewrite确保请求路径不被错误重写如/backend/login不会变成/login。5.3 解决“验证码图片404”和“上传菜品图片失败”两个高频问题登录页右侧验证码不显示上传菜品时提示“上传失败”根源都在reggie-backend/src/main/resources/application.yml的reggie.path配置# 必须与你的实际文件系统路径严格一致 reggie: path: /Users/yourname/reggie/upload/ # macOS/Linux # reggie.path: C:/reggie/upload/ # Windows注意斜杠方向操作步骤在文件系统中创建该目录如mkdir -p /Users/yourname/reggie/upload赋予Java进程写权限chmod 755 /Users/yourname/reggie/upload重启reggie-backend否则配置不生效参数说明reggie.path是后端保存上传文件的物理路径。前端上传时后端将图片存至此目录并返回/common/download?namexxx.jpg这样的URL。如果目录不存在或无写权限FileUtils.copyInputStreamToFile会抛IOException前端收到500。6. 避坑指南5个血泪经验总结省下你三天排查时间以下是我在指导32名学员搭建瑞吉外卖环境时反复出现的5个“看似简单、实则致命”的坑。每一条都附带现象→原因→解决的闭环拒绝模糊描述。6.1 现象后端启动日志显示Started ReggieApplication但curl http://localhost:8080/backend/employee/login返回404原因reggie-backend/src/main/java/com/example/reggie/config/WebMvcConfig.java中addResourceHandlers方法被误删或注释导致/backend/**路径未被Spring MVC注册为Controller映射。解决打开该文件确认存在以下代码块尤其注意registry.addResourceHandler(/backend/**)Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/backend/**) .addResourceLocations(classpath:/backend/); registry.addResourceHandler(/front/**) .addResourceLocations(classpath:/front/); }6.2 现象登录成功后跳转到http://localhost:8081/employee/page页面空白Console报GET http://localhost:8081/employee/page 404 (Not Found)原因前端路由是History模式但Webpack Dev Server未配置historyApiFallback导致刷新页面时Nginx/Apache找不到/employee/page对应的HTML。解决修改reggie-front/vue.config.js在devServer对象内添加devServer: { historyApiFallback: { rewrites: [ { from: /^\/.*$/, to: /index.html } ] } }6.3 现象MySQL导入sql/reggie.sql时卡住或报ERROR 1067 (42000): Invalid default value for create_time原因MySQL 5.7默认启用STRICT_TRANS_TABLES模式而SQL脚本中create_time DATETIME DEFAULT NULL不符合严格模式。解决临时关闭严格模式仅开发环境SET GLOBAL sql_mode(SELECT REPLACE(sql_mode,STRICT_TRANS_TABLES,)); -- 然后重新执行 SOURCE sql/reggie.sql6.4 现象IDEA中ReggieApplication.java右键Run控制台报java.lang.ClassNotFoundException: com.example.reggie.entity.Employee原因Maven项目未正确加载reggie-entity模块或reggie-backend/pom.xml中module../reggie-entity/module路径错误如多了一层..。解决在IDEA中右键项目 →Maven→Reload project然后检查reggie-backend/pom.xml的modules部分确保路径为modules module../reggie-common/module module../reggie-entity/module module../reggie-mapper/module !-- 其他module -- /modules6.5 现象上传菜品图片后列表中图片显示为叉号Network中/common/download?namexxx.jpg返回404原因reggie.path配置的路径是相对路径如upload/但Spring Boot要求必须是绝对路径或路径中包含中文、空格导致File对象构造失败。解决将application.yml中reggie.path改为绝对路径且不含中文/空格reggie: path: /Users/yourname/reggie/upload/ # ✅ 正确macOS # reggie.path: C:\\reggie\\upload\\ # ✅ 正确Windows双反斜杠 # reggie.path: upload/ # ❌ 错误相对路径 # reggie.path: /Users/张三/reggie/upload/ # ❌ 错误含中文7. 进阶技巧用Actuator端点实时监控后端健康状态把“黑匣子”变成透明仪表盘当项目跑起来后别急着写新功能。先给后端装上“行车记录仪”——Spring Boot Actuator。它能在不改一行业务代码的前提下暴露内存、线程、HTTP请求链路等关键指标让“为什么慢”“哪里崩了”从玄学变成可查日志。7.1 启用Actuator并开放必要端点在reggie-backend/pom.xml中添加Actuator Starterv1.4.0默认未引入dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency然后在application.yml末尾追加management: endpoints: web: exposure: include: health,info,metrics,threaddump,env base-path: /actuator endpoint: health: show-details: always参数说明exposure.include指定开放的端点health健康检查、metricsJVM指标、threaddump线程快照是诊断性能问题的黄金组合show-details: always让/actuator/health返回数据库连接、Redis如有等详细状态而非仅UP/DOWN。7.2 验证Actuator端点并解读关键指标重启后端访问http://localhost:8080/actuator/health→ 返回JSONstatus: UP且含diskSpace、db子节点证明磁盘和数据库连通。http://localhost:8080/actuator/metrics/jvm.memory.max→ 查看JVM最大堆内存单位字节若远小于你设置的-Xmx说明GC频繁。http://localhost:8080/actuator/threaddump→ 下载线程快照用 fastthread.io 在线分析定位死锁或CPU飙高线程。7.3 用PrometheusGrafana搭建轻量监控可选但强烈推荐如果你有10分钟可以搭一个可视化监控下载Prometheushttps://prometheus.io/download/解压后修改prometheus.ymlscrape_configs: - job_name: reggie metrics_path: /actuator/prometheus static_configs: - targets: [localhost:8080]启动Prometheus./prometheus --config.fileprometheus.yml访问http://localhost:9090/targets看到reggie状态为UP即接入成功。我的习惯每次给新学员配环境我必加Actuator。因为90%的“启动失败”问题看一眼/actuator/health的details字段就定位了——比如db节点显示status:DOWN立刻去查数据库连接参数diskSpace显示free:0马上清磁盘。这比翻几百行日志快十倍。希望帮到你。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
