简介这是一套面向高校学生的Java销售评价系统完整项目资源适用于课程设计、毕业设计及Java Web入门到进阶的实战练习。项目围绕商品与服务评价管理展开涵盖用户、角色、销售、评分等核心模块帮助读者理解从需求设计到编码落地的完整开发链路。压缩包共389个文件约53.74MB包含19个java源码文件、19个class编译文件、76个xml配置、66个js与22个html前端页面、12个css样式以及gif演示图、mp4视频和properties配置等结构完整、层次清晰。资源内含演示视频、部署视频、数据库文档与部署源码读者可对照视频快速搭建运行环境阅读源码理解控制器与实体类的设计思路并借助数据库文档掌握表结构与后端设计方法。目前已有34人学习适合希望提升Java开发与软件工程实践能力的学生参考。1. 销售评价系统拆包一份 Java 课程设计资源到底能跑出什么做过课程设计的人都懂那种感觉选题定了“销售评价系统”听起来业务清晰、功能闭环真动手才发现评价维度怎么设计、前后端怎么串、数据库表怎么拆每一步都能卡住两三天。这份基于 Java 的销售评价系统资源恰好是冲着这个痛点来的——它不是一段孤立的代码而是一整套从演示视频、部署视频、数据库文档到部署源码的完整交付物。从类名结构看ScoreController、UserController、SalesController、RoleController 四个控制器分别对应评价、用户、销售、角色四条业务线Score、User、Sales、MenuOne、MenuTwo 则是典型的实体与菜单模型整体是标准的 MVC 分层思路。它适合正在做毕业设计或课程设计的学生也适合想拿一个完整 Java Web 项目练手、把“能跑起来”和“讲得清楚”两件事同时办掉的人。下面我按实际拆包的顺序把这份资源怎么用、参数怎么对、坑在哪一条条讲透。2. 从 class 文件反推架构控制器与实体怎么对应业务2.1 四个 Controller 的职责边界拿到一份只有 class 文件的源码包第一件事不是急着反编译而是从命名推断分层。ScoreController 管评价的增删改查和统计UserController 管登录、注册、权限校验SalesController 管销售记录和商品信息RoleController 管角色与菜单的绑定。这四个控制器基本覆盖了一个销售评价系统的最小闭环用户登录后产生销售行为销售行为触发评价评价数据再按角色权限展示给不同的人看。常见做法是每个 Controller 对应一张主表和若干从表。比如 ScoreController 背后至少要有 score 表存评价内容、score_item 表存评分项、score_stat 表存汇总。从资源里出现的 MenuOne 和 MenuTwo 两个菜单类能看出系统做了两级菜单权限MenuOne 是父级模块MenuTwo 是子级功能点RoleController 负责把角色和菜单做关联。这种设计在课程设计里算比较规范的比那种所有逻辑塞一个 Servlet 的写法强不少。提示如果你拿到的只有 class 没有 java先用 JD-GUI 或 CFR 反编译重点看 Controller 里的 RequestMapping 注解那是接口清单的直接来源。2.2 实体类与数据库表的映射关系Score、User、Sales 三个实体类对应核心业务表字段命名通常是驼峰转下划线。比如 User 类里的 userName 对应 user_name 列createTime 对应 create_time。MenuOne 和 MenuTwo 因为带层级关系一般会有 parentId 和 menuUrl 两个关键字段前者指向上级菜单后者是前端路由地址。下面这段是典型的实体类结构我按常见写法还原你对照手里的 class 反编译结果看字段名是否一致public class Score { private Integer scoreId; // 评价主键 private Integer salesId; // 关联销售记录 private Integer userId; // 评价人 private Integer scoreValue; // 综合评分 1-5 private String scoreContent; // 评价正文 private Date createTime; // 评价时间 // getter/setter 省略 }逻辑说明scoreId 是自增主键salesId 和 userId 是两个外键分别指向 sales 表和 user 表。scoreValue 用整数存 1 到 5 的星级比用浮点数省事统计时直接 AVG 就行。createTime 用 Date 类型插入时由数据库默认值或代码里 new Date() 赋值。参数说明scoreValue 的范围要在业务层做校验别指望前端传什么就存什么。我见过有人直接存了 0 分和 6 分统计报表出来全是异常值。scoreContent 建议设 varchar(500)课程设计里够用太长的话前端展示也要截断。2.3 部署视频与数据库文档的配合用法部署视频和数据库文档这两样东西要配合着看。先看数据库文档把表结构和字段含义过一遍心里有张 ER 图再看部署视频跟着操作配环境。顺序反了的话视频里讲到“导入 sql 文件”你都不知道那个文件里有什么。数据库文档一般包含表清单、字段说明、索引设计和 ER 图。重点看三处主外键关系、字段类型和长度、有没有初始化数据。初始化数据里通常有默认管理员账号和菜单权限数据没有的话系统登录进去是白板。部署视频里会讲 Tomcat 版本、JDK 版本、数据库连接配置改哪里这些参数一个都不能错后面避坑章节会细说。3. 本地跑通部署源码环境、数据库、启动三步走3.1 JDK 与 Tomcat 版本对齐Java Web 项目最怕版本不对齐。从 class 文件结构看这份资源大概率是 JDK 8 编译的因为国内课程设计项目绝大多数停留在 JDK 8 Tomcat 8 或 9 的组合。你要是用 JDK 17 去跑启动时报“源发行版 17 需要目标发行版 17”还算是好的怕的是 class 版本不兼容直接抛 UnsupportedClassVersionError。我一般会先确认三件事java -version看 JDK 版本echo %JAVA_HOME%Windows或echo $JAVA_HOMELinux/Mac看环境变量指向Tomcat 的 lib 目录下有没有 servlet-api.jar。三个都对上了再往下走。# 检查 JDK 版本确认是 1.8 java -version # 检查 JAVA_HOME 是否指向 JDK 而非 JRE echo $JAVA_HOME # 查看 Tomcat 版本 $CATALINA_HOME/bin/version.sh逻辑说明第一条命令输出 java version 1.8.0_xxx 才说明 JDK 8 在位。第二条确认 JAVA_HOME 指向 JDK 根目录不是 JRE否则编译 JSP 时会找不到 tools.jar。第三条看 Tomcat 版本8.5 或 9.0 都行10 以上因为包名从 javax 变成 jakarta老项目跑不起来。参数说明如果 JAVA_HOME 没配Windows 在系统变量里新建Linux/Mac 在 ~/.bashrc 或 ~/.zshrc 里 export。Tomcat 的端口默认 8080被占用的话改 conf/server.xml 里的 Connector port。3.2 数据库导入与连接配置修改数据库文档里的 sql 文件用 Navicat 或命令行导入都行。命令行导入的好处是能看到报错图形化工具有时候静默失败。# 创建数据库字符集用 utf8mb4 mysql -u root -p -e CREATE DATABASE sales_score DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 导入 sql 文件 mysql -u root -p sales_score /path/to/database.sql # 验证表是否导入成功 mysql -u root -p sales_score -e SHOW TABLES;逻辑说明第一条建库时指定 utf8mb4避免中文评价内容存进去变问号。第二条把 sql 文件灌进去路径换成你实际存放的位置。第三条列出所有表对照数据库文档里的表清单核对数量。参数说明数据库名 sales_score 是我按项目习惯起的你导入的 sql 文件里如果有 CREATE DATABASE 语句直接用文件里的名字。字符集必须是 utf8mb4utf8 在三字节以上字符会出问题虽然课程设计里一般用不到 emoji但养成习惯没坏处。导入完成后改连接配置。配置文件通常是 db.properties、jdbc.properties 或直接在 spring 配置里。重点改 url、username、password 三项。url 里的数据库名要和刚才建的一致时区参数加上 serverTimezoneAsia/Shanghai不然插入时间会差 8 小时。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/sales_score?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的密码逻辑说明driver 用 com.mysql.cj.jdbc.Driver 是 MySQL 8 的写法MySQL 5 用 com.mysql.jdbc.Driver。url 里三个参数分别管编码、时区和 SSL课程设计本地跑不加 useSSLfalse 会有一堆警告。参数说明username 和 password 换成你本地的。如果 MySQL 是 8.0 以上密码认证插件可能是 caching_sha2_password老版本驱动连不上要么升级驱动 jar要么改用户认证方式。3.3 项目导入 IDE 与启动验证Eclipse 和 IDEA 都行IDEA 对老项目兼容更好。导入时选 Existing Maven Project 或直接 Open看项目根目录有没有 pom.xml。没有 pom 的话就是传统 Web 项目需要手动配 Facets 和 Artifacts。启动前检查 WebContent 或 webapp 目录下有没有 lib 文件夹里面是项目依赖的 jar。缺 jar 的话启动报 ClassNotFoundException根据报错类名去 Maven 仓库下对应的包丢进去。启动成功后访问http://localhost:8080/项目名/默认跳登录页。用数据库文档里的初始账号登录没有的话去 user 表里看第一条记录密码可能是明文也可能是 MD5明文直接试MD5 的话用在线工具解或者看部署视频里有没有提。注意如果登录后菜单是空的去 menu_one 和 menu_two 表里看有没有数据以及 role_menu 关联表里当前角色有没有绑定菜单。这是权限系统最常见的“白板”问题。4. 评价功能与权限菜单的联动排查4.1 评价提交后数据不落库的排查路径评价提交是最核心的功能也是最容易出问题的地方。现象是前端提示提交成功但数据库里没数据或者直接报 500。排查按从前到后的顺序走先看浏览器 Network 里请求有没有发出去再看 Controller 有没有收到再看 SQL 有没有执行。// ScoreController 里典型的保存逻辑 RequestMapping(/score/save) ResponseBody public MapString, Object saveScore(Score score, HttpSession session) { MapString, Object result new HashMap(); User user (User) session.getAttribute(loginUser); if (user null) { result.put(code, 401); result.put(msg, 未登录); return result; } score.setUserId(user.getUserId()); score.setCreateTime(new Date()); int rows scoreService.insert(score); result.put(code, rows 0 ? 200 : 500); result.put(msg, rows 0 ? 成功 : 失败); return result; }逻辑说明先从 session 取登录用户取不到直接返回 401这一步能挡掉大部分未登录提交。然后补全 userId 和 createTime这两个字段前端一般不传由后端填充。最后调 service 插入根据影响行数判断成败。参数说明score 对象由 Spring MVC 自动绑定前端表单字段名要和 Score 类属性名一致否则绑不上。比如前端传score_value而类里是scoreValue需要配 RequestParam 或改前端 name。如果这里返回 200 但数据库没数据检查三处service 层有没有加 Transactional 且抛异常被吞了、MyBatis 的 insert 语句有没有写错表名、数据库连接是不是连到了另一个库。我踩过的坑是本地有两个同名的库一个空一个有数据配置里连错了查了半天。4.2 角色菜单权限的加载逻辑MenuOne 和 MenuTwo 的加载顺序是先查角色对应的菜单 ID 列表再根据 ID 查菜单详情最后组装成树形结构返回前端。RoleController 里通常有一个/role/menu接口干这件事。-- 查当前角色的菜单权限 SELECT m.* FROM menu_two m INNER JOIN role_menu rm ON m.menu_id rm.menu_id WHERE rm.role_id ? ORDER BY m.sort_order;逻辑说明role_menu 是角色和菜单的关联表一个角色对应多条菜单记录。查出来的菜单按 sort_order 排序前端按顺序渲染。参数说明role_id 从 session 里的当前用户取。如果查出来是空先确认 role_menu 表里有没有这个角色的数据再确认 menu_id 在 menu_two 表里存不存在。外键没约束的话关联表里可能有脏数据。菜单树组装时注意 parentId 为 0 或 null 的是顶级菜单其余按 parentId 挂到对应父节点下。前端用递归或树组件渲染。如果菜单显示但点击 404检查 menuUrl 字段和实际 Controller 的 RequestMapping 是否一致大小写和斜杠都不能差。4.3 销售记录与评价的关联查询销售评价系统的核心价值在于“哪笔销售被评价了、评价内容是什么”。这需要 sales 表和 score 表做关联查询。常见做法是在 SalesController 的列表接口里 left join score 表把评价状态和评分带出来。SELECT s.*, sc.score_value, sc.score_content FROM sales s LEFT JOIN score sc ON s.sales_id sc.sales_id WHERE s.user_id ? ORDER BY s.create_time DESC;逻辑说明用 left join 保证没有评价的销售记录也能查出来score_value 为 null 表示未评价。前端根据这个字段显示“去评价”或“查看评价”。参数说明user_id 是当前登录用户如果系统区分销售员和顾客这里要按角色过滤。order by 按时间倒序最新的排前面。这个查询在数据量大的时候会慢课程设计里几十条数据无所谓但养成加索引的习惯sales 表的 user_id 和 create_time 加联合索引score 表的 sales_id 加索引。5. 避坑与常见问题版本、编码、权限的翻车记录5.1 启动报 404 但 Tomcat 正常现象Tomcat 启动日志没有报错访问项目路径返回 404。原因项目没有部署到 Tomcat 的 webapps 目录或者 IDEA 的 Artifact 没配好编译输出路径不对。解决在 IDEA 的 Project Structure 里检查 Artifacts确保 Output Layout 里有 WEB-INF 和编译后的 classes。Eclipse 的话检查 Deployment Assembly 有没有把源码目录映射到 WEB-INF/classes。5.2 中文评价内容存进去变问号现象前端输入中文评价提交后数据库里显示???。原因数据库连接 url 没加 characterEncodingutf8或者数据库和表的字符集不是 utf8mb4。解决改 jdbc url 加characterEncodingutf8然后ALTER DATABASE sales_score CHARACTER SET utf8mb4;和ALTER TABLE score CONVERT TO CHARACTER SET utf8mb4;。已经存进去的乱码数据改不回来只能删了重录。5.3 登录后菜单空白现象登录成功跳转到主页但左侧菜单栏是空的。原因role_menu 表里当前角色没有关联任何菜单或者 menu_two 表的 parentId 指向了一个不存在的父菜单。解决先查SELECT * FROM role_menu WHERE role_id 你的角色ID;空的话手动插入关联数据。再查SELECT * FROM menu_two WHERE parent_id NOT IN (SELECT menu_id FROM menu_one);有结果说明有孤儿菜单改 parent_id 或补父菜单记录。5.4 评价提交报 500 且日志显示 SQL 语法错误现象提交评价时页面报 500Tomcat 日志里是 SQLSyntaxErrorException。原因MyBatis 的 mapper xml 里 insert 语句的字段名和数据库列名对不上或者 values 里的占位符数量和字段数量不一致。解决把日志里的 SQL 复制出来在数据库客户端直接执行看报错位置。常见的是多了一个逗号、少了一个#{}、或者字段名拼写错误。MyBatis 的#{}和${}别混用前者是预编译占位符后者是字符串拼接用错会有 SQL 注入风险。5.5 部署视频里的路径和本地不一致现象跟着部署视频操作视频里是 D 盘某个目录你本地没有或者视频里的 Tomcat 版本和你下的不一样。原因录制环境和个人环境差异这是看视频部署最常见的坑。解决路径按你本地的来视频只关注操作顺序和配置项名称不要照抄绝对路径。Tomcat 版本差异不大的话8.5 和 9.0操作基本一致10 以上不适用。数据库版本差异要注意MySQL 5 和 8 的驱动类和 url 参数不同前面 3.2 节已经写了对照。6. 二次开发与答辩加分从能跑到讲得清把系统跑起来只是第一步课程设计和毕业设计真正拉开差距的是你能不能讲清楚“为什么这么设计”和“我改了什么”。这份资源给了你一个完整的底子接下来做三件事就能从“跑通”变成“拿得出手”。第一件事给评价功能加一个统计接口。原始系统大概率只有评价的增删改查你加一个按销售员维度算平均分的接口前端用 ECharts 画个柱状图。代码不复杂但答辩时演示出来效果完全不一样。RequestMapping(/score/stat) ResponseBody public MapString, Object statBySales(HttpSession session) { MapString, Object result new HashMap(); User user (User) session.getAttribute(loginUser); if (user null) { result.put(code, 401); return result; } // 按销售员分组算平均分和评价数 ListMapString, Object list scoreService.statBySalesId(); result.put(code, 200); result.put(data, list); return result; }逻辑说明接口从 session 拿登录用户做鉴权然后调 service 层的统计方法。service 里对应的 SQL 是SELECT sales_id, AVG(score_value) AS avg_score, COUNT(*) AS cnt FROM score GROUP BY sales_id。返回的 list 直接给前端图表用。参数说明如果系统区分角色这里可以加一个判断普通用户只看自己的管理员看全部。AVG 的结果是 BigDecimal前端拿到后 toFixed(1) 保留一位小数。第二件事把数据库文档里的 ER 图自己重画一遍用 draw.io 或 ProcessOn把主外键关系标清楚。答辩时老师问“你这个评价表和销售表怎么关联的”你直接切到 ER 图讲比翻代码快得多。第三件事准备一个“如果数据量涨到十万条怎么办”的回答。课程设计的数据量小但老师喜欢问扩展性问题。你可以说评价表的 sales_id 加索引、统计查询走缓存、分页查询用 limit 而不是全量返回。这些不用真做但你要能说出来。提示部署视频里如果讲了 Tomcat 的 JVM 参数调优记下来答辩时提一句“部署时调整了堆内存”是个小加分项。我自己的习惯是每次拿到一个课程设计项目先跑通再改一个功能最后把改动点整理成三页 PPT。从那以后我每次做课程设计都强制走一遍“跑通→改一处→讲清楚”的流程比单纯交一份能跑的代码踏实得多。希望帮到你。本文还有配套的精品资源点击获取
简介这是一套面向高校学生的Java销售评价系统完整项目资源适用于课程设计、毕业设计及Java Web入门到进阶的实战练习。项目围绕商品与服务评价管理展开涵盖用户、角色、销售、评分等核心模块帮助读者理解从需求设计到编码落地的完整开发链路。压缩包共389个文件约53.74MB包含19个java源码文件、19个class编译文件、76个xml配置、66个js与22个html前端页面、12个css样式以及gif演示图、mp4视频和properties配置等结构完整、层次清晰。资源内含演示视频、部署视频、数据库文档与部署源码读者可对照视频快速搭建运行环境阅读源码理解控制器与实体类的设计思路并借助数据库文档掌握表结构与后端设计方法。目前已有34人学习适合希望提升Java开发与软件工程实践能力的学生参考。1. 销售评价系统拆包一份 Java 课程设计资源到底能跑出什么做过课程设计的人都懂那种感觉选题定了“销售评价系统”听起来业务清晰、功能闭环真动手才发现评价维度怎么设计、前后端怎么串、数据库表怎么拆每一步都能卡住两三天。这份基于 Java 的销售评价系统资源恰好是冲着这个痛点来的——它不是一段孤立的代码而是一整套从演示视频、部署视频、数据库文档到部署源码的完整交付物。从类名结构看ScoreController、UserController、SalesController、RoleController 四个控制器分别对应评价、用户、销售、角色四条业务线Score、User、Sales、MenuOne、MenuTwo 则是典型的实体与菜单模型整体是标准的 MVC 分层思路。它适合正在做毕业设计或课程设计的学生也适合想拿一个完整 Java Web 项目练手、把“能跑起来”和“讲得清楚”两件事同时办掉的人。下面我按实际拆包的顺序把这份资源怎么用、参数怎么对、坑在哪一条条讲透。2. 从 class 文件反推架构控制器与实体怎么对应业务2.1 四个 Controller 的职责边界拿到一份只有 class 文件的源码包第一件事不是急着反编译而是从命名推断分层。ScoreController 管评价的增删改查和统计UserController 管登录、注册、权限校验SalesController 管销售记录和商品信息RoleController 管角色与菜单的绑定。这四个控制器基本覆盖了一个销售评价系统的最小闭环用户登录后产生销售行为销售行为触发评价评价数据再按角色权限展示给不同的人看。常见做法是每个 Controller 对应一张主表和若干从表。比如 ScoreController 背后至少要有 score 表存评价内容、score_item 表存评分项、score_stat 表存汇总。从资源里出现的 MenuOne 和 MenuTwo 两个菜单类能看出系统做了两级菜单权限MenuOne 是父级模块MenuTwo 是子级功能点RoleController 负责把角色和菜单做关联。这种设计在课程设计里算比较规范的比那种所有逻辑塞一个 Servlet 的写法强不少。提示如果你拿到的只有 class 没有 java先用 JD-GUI 或 CFR 反编译重点看 Controller 里的 RequestMapping 注解那是接口清单的直接来源。2.2 实体类与数据库表的映射关系Score、User、Sales 三个实体类对应核心业务表字段命名通常是驼峰转下划线。比如 User 类里的 userName 对应 user_name 列createTime 对应 create_time。MenuOne 和 MenuTwo 因为带层级关系一般会有 parentId 和 menuUrl 两个关键字段前者指向上级菜单后者是前端路由地址。下面这段是典型的实体类结构我按常见写法还原你对照手里的 class 反编译结果看字段名是否一致public class Score { private Integer scoreId; // 评价主键 private Integer salesId; // 关联销售记录 private Integer userId; // 评价人 private Integer scoreValue; // 综合评分 1-5 private String scoreContent; // 评价正文 private Date createTime; // 评价时间 // getter/setter 省略 }逻辑说明scoreId 是自增主键salesId 和 userId 是两个外键分别指向 sales 表和 user 表。scoreValue 用整数存 1 到 5 的星级比用浮点数省事统计时直接 AVG 就行。createTime 用 Date 类型插入时由数据库默认值或代码里 new Date() 赋值。参数说明scoreValue 的范围要在业务层做校验别指望前端传什么就存什么。我见过有人直接存了 0 分和 6 分统计报表出来全是异常值。scoreContent 建议设 varchar(500)课程设计里够用太长的话前端展示也要截断。2.3 部署视频与数据库文档的配合用法部署视频和数据库文档这两样东西要配合着看。先看数据库文档把表结构和字段含义过一遍心里有张 ER 图再看部署视频跟着操作配环境。顺序反了的话视频里讲到“导入 sql 文件”你都不知道那个文件里有什么。数据库文档一般包含表清单、字段说明、索引设计和 ER 图。重点看三处主外键关系、字段类型和长度、有没有初始化数据。初始化数据里通常有默认管理员账号和菜单权限数据没有的话系统登录进去是白板。部署视频里会讲 Tomcat 版本、JDK 版本、数据库连接配置改哪里这些参数一个都不能错后面避坑章节会细说。3. 本地跑通部署源码环境、数据库、启动三步走3.1 JDK 与 Tomcat 版本对齐Java Web 项目最怕版本不对齐。从 class 文件结构看这份资源大概率是 JDK 8 编译的因为国内课程设计项目绝大多数停留在 JDK 8 Tomcat 8 或 9 的组合。你要是用 JDK 17 去跑启动时报“源发行版 17 需要目标发行版 17”还算是好的怕的是 class 版本不兼容直接抛 UnsupportedClassVersionError。我一般会先确认三件事java -version看 JDK 版本echo %JAVA_HOME%Windows或echo $JAVA_HOMELinux/Mac看环境变量指向Tomcat 的 lib 目录下有没有 servlet-api.jar。三个都对上了再往下走。# 检查 JDK 版本确认是 1.8 java -version # 检查 JAVA_HOME 是否指向 JDK 而非 JRE echo $JAVA_HOME # 查看 Tomcat 版本 $CATALINA_HOME/bin/version.sh逻辑说明第一条命令输出 java version 1.8.0_xxx 才说明 JDK 8 在位。第二条确认 JAVA_HOME 指向 JDK 根目录不是 JRE否则编译 JSP 时会找不到 tools.jar。第三条看 Tomcat 版本8.5 或 9.0 都行10 以上因为包名从 javax 变成 jakarta老项目跑不起来。参数说明如果 JAVA_HOME 没配Windows 在系统变量里新建Linux/Mac 在 ~/.bashrc 或 ~/.zshrc 里 export。Tomcat 的端口默认 8080被占用的话改 conf/server.xml 里的 Connector port。3.2 数据库导入与连接配置修改数据库文档里的 sql 文件用 Navicat 或命令行导入都行。命令行导入的好处是能看到报错图形化工具有时候静默失败。# 创建数据库字符集用 utf8mb4 mysql -u root -p -e CREATE DATABASE sales_score DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 导入 sql 文件 mysql -u root -p sales_score /path/to/database.sql # 验证表是否导入成功 mysql -u root -p sales_score -e SHOW TABLES;逻辑说明第一条建库时指定 utf8mb4避免中文评价内容存进去变问号。第二条把 sql 文件灌进去路径换成你实际存放的位置。第三条列出所有表对照数据库文档里的表清单核对数量。参数说明数据库名 sales_score 是我按项目习惯起的你导入的 sql 文件里如果有 CREATE DATABASE 语句直接用文件里的名字。字符集必须是 utf8mb4utf8 在三字节以上字符会出问题虽然课程设计里一般用不到 emoji但养成习惯没坏处。导入完成后改连接配置。配置文件通常是 db.properties、jdbc.properties 或直接在 spring 配置里。重点改 url、username、password 三项。url 里的数据库名要和刚才建的一致时区参数加上 serverTimezoneAsia/Shanghai不然插入时间会差 8 小时。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/sales_score?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的密码逻辑说明driver 用 com.mysql.cj.jdbc.Driver 是 MySQL 8 的写法MySQL 5 用 com.mysql.jdbc.Driver。url 里三个参数分别管编码、时区和 SSL课程设计本地跑不加 useSSLfalse 会有一堆警告。参数说明username 和 password 换成你本地的。如果 MySQL 是 8.0 以上密码认证插件可能是 caching_sha2_password老版本驱动连不上要么升级驱动 jar要么改用户认证方式。3.3 项目导入 IDE 与启动验证Eclipse 和 IDEA 都行IDEA 对老项目兼容更好。导入时选 Existing Maven Project 或直接 Open看项目根目录有没有 pom.xml。没有 pom 的话就是传统 Web 项目需要手动配 Facets 和 Artifacts。启动前检查 WebContent 或 webapp 目录下有没有 lib 文件夹里面是项目依赖的 jar。缺 jar 的话启动报 ClassNotFoundException根据报错类名去 Maven 仓库下对应的包丢进去。启动成功后访问http://localhost:8080/项目名/默认跳登录页。用数据库文档里的初始账号登录没有的话去 user 表里看第一条记录密码可能是明文也可能是 MD5明文直接试MD5 的话用在线工具解或者看部署视频里有没有提。注意如果登录后菜单是空的去 menu_one 和 menu_two 表里看有没有数据以及 role_menu 关联表里当前角色有没有绑定菜单。这是权限系统最常见的“白板”问题。4. 评价功能与权限菜单的联动排查4.1 评价提交后数据不落库的排查路径评价提交是最核心的功能也是最容易出问题的地方。现象是前端提示提交成功但数据库里没数据或者直接报 500。排查按从前到后的顺序走先看浏览器 Network 里请求有没有发出去再看 Controller 有没有收到再看 SQL 有没有执行。// ScoreController 里典型的保存逻辑 RequestMapping(/score/save) ResponseBody public MapString, Object saveScore(Score score, HttpSession session) { MapString, Object result new HashMap(); User user (User) session.getAttribute(loginUser); if (user null) { result.put(code, 401); result.put(msg, 未登录); return result; } score.setUserId(user.getUserId()); score.setCreateTime(new Date()); int rows scoreService.insert(score); result.put(code, rows 0 ? 200 : 500); result.put(msg, rows 0 ? 成功 : 失败); return result; }逻辑说明先从 session 取登录用户取不到直接返回 401这一步能挡掉大部分未登录提交。然后补全 userId 和 createTime这两个字段前端一般不传由后端填充。最后调 service 插入根据影响行数判断成败。参数说明score 对象由 Spring MVC 自动绑定前端表单字段名要和 Score 类属性名一致否则绑不上。比如前端传score_value而类里是scoreValue需要配 RequestParam 或改前端 name。如果这里返回 200 但数据库没数据检查三处service 层有没有加 Transactional 且抛异常被吞了、MyBatis 的 insert 语句有没有写错表名、数据库连接是不是连到了另一个库。我踩过的坑是本地有两个同名的库一个空一个有数据配置里连错了查了半天。4.2 角色菜单权限的加载逻辑MenuOne 和 MenuTwo 的加载顺序是先查角色对应的菜单 ID 列表再根据 ID 查菜单详情最后组装成树形结构返回前端。RoleController 里通常有一个/role/menu接口干这件事。-- 查当前角色的菜单权限 SELECT m.* FROM menu_two m INNER JOIN role_menu rm ON m.menu_id rm.menu_id WHERE rm.role_id ? ORDER BY m.sort_order;逻辑说明role_menu 是角色和菜单的关联表一个角色对应多条菜单记录。查出来的菜单按 sort_order 排序前端按顺序渲染。参数说明role_id 从 session 里的当前用户取。如果查出来是空先确认 role_menu 表里有没有这个角色的数据再确认 menu_id 在 menu_two 表里存不存在。外键没约束的话关联表里可能有脏数据。菜单树组装时注意 parentId 为 0 或 null 的是顶级菜单其余按 parentId 挂到对应父节点下。前端用递归或树组件渲染。如果菜单显示但点击 404检查 menuUrl 字段和实际 Controller 的 RequestMapping 是否一致大小写和斜杠都不能差。4.3 销售记录与评价的关联查询销售评价系统的核心价值在于“哪笔销售被评价了、评价内容是什么”。这需要 sales 表和 score 表做关联查询。常见做法是在 SalesController 的列表接口里 left join score 表把评价状态和评分带出来。SELECT s.*, sc.score_value, sc.score_content FROM sales s LEFT JOIN score sc ON s.sales_id sc.sales_id WHERE s.user_id ? ORDER BY s.create_time DESC;逻辑说明用 left join 保证没有评价的销售记录也能查出来score_value 为 null 表示未评价。前端根据这个字段显示“去评价”或“查看评价”。参数说明user_id 是当前登录用户如果系统区分销售员和顾客这里要按角色过滤。order by 按时间倒序最新的排前面。这个查询在数据量大的时候会慢课程设计里几十条数据无所谓但养成加索引的习惯sales 表的 user_id 和 create_time 加联合索引score 表的 sales_id 加索引。5. 避坑与常见问题版本、编码、权限的翻车记录5.1 启动报 404 但 Tomcat 正常现象Tomcat 启动日志没有报错访问项目路径返回 404。原因项目没有部署到 Tomcat 的 webapps 目录或者 IDEA 的 Artifact 没配好编译输出路径不对。解决在 IDEA 的 Project Structure 里检查 Artifacts确保 Output Layout 里有 WEB-INF 和编译后的 classes。Eclipse 的话检查 Deployment Assembly 有没有把源码目录映射到 WEB-INF/classes。5.2 中文评价内容存进去变问号现象前端输入中文评价提交后数据库里显示???。原因数据库连接 url 没加 characterEncodingutf8或者数据库和表的字符集不是 utf8mb4。解决改 jdbc url 加characterEncodingutf8然后ALTER DATABASE sales_score CHARACTER SET utf8mb4;和ALTER TABLE score CONVERT TO CHARACTER SET utf8mb4;。已经存进去的乱码数据改不回来只能删了重录。5.3 登录后菜单空白现象登录成功跳转到主页但左侧菜单栏是空的。原因role_menu 表里当前角色没有关联任何菜单或者 menu_two 表的 parentId 指向了一个不存在的父菜单。解决先查SELECT * FROM role_menu WHERE role_id 你的角色ID;空的话手动插入关联数据。再查SELECT * FROM menu_two WHERE parent_id NOT IN (SELECT menu_id FROM menu_one);有结果说明有孤儿菜单改 parent_id 或补父菜单记录。5.4 评价提交报 500 且日志显示 SQL 语法错误现象提交评价时页面报 500Tomcat 日志里是 SQLSyntaxErrorException。原因MyBatis 的 mapper xml 里 insert 语句的字段名和数据库列名对不上或者 values 里的占位符数量和字段数量不一致。解决把日志里的 SQL 复制出来在数据库客户端直接执行看报错位置。常见的是多了一个逗号、少了一个#{}、或者字段名拼写错误。MyBatis 的#{}和${}别混用前者是预编译占位符后者是字符串拼接用错会有 SQL 注入风险。5.5 部署视频里的路径和本地不一致现象跟着部署视频操作视频里是 D 盘某个目录你本地没有或者视频里的 Tomcat 版本和你下的不一样。原因录制环境和个人环境差异这是看视频部署最常见的坑。解决路径按你本地的来视频只关注操作顺序和配置项名称不要照抄绝对路径。Tomcat 版本差异不大的话8.5 和 9.0操作基本一致10 以上不适用。数据库版本差异要注意MySQL 5 和 8 的驱动类和 url 参数不同前面 3.2 节已经写了对照。6. 二次开发与答辩加分从能跑到讲得清把系统跑起来只是第一步课程设计和毕业设计真正拉开差距的是你能不能讲清楚“为什么这么设计”和“我改了什么”。这份资源给了你一个完整的底子接下来做三件事就能从“跑通”变成“拿得出手”。第一件事给评价功能加一个统计接口。原始系统大概率只有评价的增删改查你加一个按销售员维度算平均分的接口前端用 ECharts 画个柱状图。代码不复杂但答辩时演示出来效果完全不一样。RequestMapping(/score/stat) ResponseBody public MapString, Object statBySales(HttpSession session) { MapString, Object result new HashMap(); User user (User) session.getAttribute(loginUser); if (user null) { result.put(code, 401); return result; } // 按销售员分组算平均分和评价数 ListMapString, Object list scoreService.statBySalesId(); result.put(code, 200); result.put(data, list); return result; }逻辑说明接口从 session 拿登录用户做鉴权然后调 service 层的统计方法。service 里对应的 SQL 是SELECT sales_id, AVG(score_value) AS avg_score, COUNT(*) AS cnt FROM score GROUP BY sales_id。返回的 list 直接给前端图表用。参数说明如果系统区分角色这里可以加一个判断普通用户只看自己的管理员看全部。AVG 的结果是 BigDecimal前端拿到后 toFixed(1) 保留一位小数。第二件事把数据库文档里的 ER 图自己重画一遍用 draw.io 或 ProcessOn把主外键关系标清楚。答辩时老师问“你这个评价表和销售表怎么关联的”你直接切到 ER 图讲比翻代码快得多。第三件事准备一个“如果数据量涨到十万条怎么办”的回答。课程设计的数据量小但老师喜欢问扩展性问题。你可以说评价表的 sales_id 加索引、统计查询走缓存、分页查询用 limit 而不是全量返回。这些不用真做但你要能说出来。提示部署视频里如果讲了 Tomcat 的 JVM 参数调优记下来答辩时提一句“部署时调整了堆内存”是个小加分项。我自己的习惯是每次拿到一个课程设计项目先跑通再改一个功能最后把改动点整理成三页 PPT。从那以后我每次做课程设计都强制走一遍“跑通→改一处→讲清楚”的流程比单纯交一份能跑的代码踏实得多。希望帮到你。本文还有配套的精品资源点击获取
