今年带本科生团队做了一套大学生双创竞赛的申报与路演管理系统，技术栈就三个东西：SpringBoot做后端，Vue写前端，MySQL存数据。源码拿到手能直接跑，基本不需要改配置。这篇东西我把从需求拆解到联调踩坑的经验都列出来，给正在做同类“信息管理系统”课设或者竞赛项目的同学做个参考。不管你是想直接拿去交作业，还是想读懂这套代码然后自己改一版，都应该能从里面找到你要的东西。
这类“双创竞赛”系统，本质上和普通的教务管理系统、科研项目管理系统没有太大差别，核心就是三件事：让参赛者能提交项目、让评委能评审打分、让管理员能排路演场次和看数据统计。但真做起来，跟前台展示型网站完全两个量级。后台状态流转、角色权限、文件上传、时间窗口控制，这些才是真正耗时间的地方。下面我按自己做这套东西的完整思路来复盘，顺便把运行、配置、排错的实操细节都交代清楚。
1. 项目背景与整体设计拆解
1.1 双创竞赛申报与路演的核心需求分析
做任何系统前，先别急着写代码，把业务链条理顺。双创竞赛通常分几个阶段：通知发布、在线申报、资格审核、专家评审、路演答辩、成绩公示。每个阶段对应不同的参与角色，系统就要把这条链子完整支撑起来。
申报阶段，学生要填写项目名称、类别（创新训练、创业训练、创业实践这类）、指导老师、团队成员、成果材料，还要上传商业计划书或者专利证明的PDF。这个阶段最怕的是信息缺胳膊断腿，所以前端表单要带必填校验和文件大小限制。审核阶段里，管理员或者二级学院审核人要对申报内容做退回和通过操作，被退回的项目要保留修改入口，而不是直接锁死。到了评审和路演阶段，评委需要能在线打分、写评语，赛程管理员要能安排路演时间、组别和评分规则。最后成绩要能汇总排名并导出Excel。
这些需求听起来朴素，但每一个都对应数据库字段、接口和前端状态流转。删除一个项目不是删一条记录的物理删除，而是逻辑删除、变更状态；路演打分不是简单存一个分数，还要考虑去掉最高分最低分的规则。这套管理系统要是没有这些细节，就只是表格搬运工，谈不上真正的信息管理。
1.2 为什么选SpringBoot+Vue+MySQL这套组合
先说结论：这套组合是当前国产课设、毕设、竞赛项目里最不容易翻车的方案。原因有三个层面。
第一，SpringBoot把旧时代Spring的XML配置几乎全干掉了，自动配置帮我们处理了大量琐碎工作。一个基于SpringBoot的信息管理系统，核心代码可以只聚焦在实体类、Mapper或Repository、Service、Controller这几层。它内嵌Tomcat，打成jar包扔到服务器上就能跑，不需要单独配Tomcat，这对新手极其友好。
第二，Vue前端做单页应用，页面跳转不需要刷新，搭配Element UI这类组件库，表格、表单、弹窗、时间选择器全部现成。管理系统的后端开发已经够累的了，前端如果再手写页面就是自虐。Vue的数据绑定和组件化，让改动一份表单、加一个卡片的成本都变得很低。
第三，MySQL是开源关系型数据库里最普及的，网上资料一抓一大把，出问题也好搜。这套系统用MySQL存业务数据，配合Spring Data JPA或者MyBatis，事务、关联查询都够用。对一个小团队的项目管理系统来说，MySQL的性能和稳定性绰绰有余，没必要上PostgreSQL或者Oracle这种大家伙。
这里要给个严肃提醒：如果自己新开项目，SpringBoot版本别追新。SpringBoot 3.x在大版本上重构了部分底层，和一众旧教程、旧依赖库兼容性有坑，尤其是一些个人写的starter和组件。老老实实选2.7.x系列，稳定且资料多。你做的是信息管理系统，不是实验性项目，稳定能跑比什么都重要。
2. 前后端核心实现与数据流设计
2.1 后端：SpringBoot的模块划分与接口设计
这套系统的后端工程结构，我按常见的Maven多module方式拆，但实际很多同学拿到的源码是单module，这也行，关键在包结构清晰。我建议至少拆成controller、service、mapper或者repository、entity、dto、config、common这几层。
Entity对应数据库表，字段能用包装类型就用包装类型，少用基本类型。例如项目状态字段如果用tinyint存0和1，Java这边用Integer比int好，空值查询时不容易出幺蛾子。DTO做请求参数和响应体的载体，不要直接把Entity怼给前端，否则后端的内部字段会全部暴露，这是新手最容易犯的错误。
接口层面，走RESTful风格。比如：
- POST /api/auth/login 登录
- POST /api/projects 创建申报项目
- GET /api/projects/my 获取当前参赛者的项目列表
- PUT /api/projects/{id}/submit 提交项目
- POST /api/reviews 评委打分
- GET /api/schedules?round=roadshow 获取路演安排
Controller层只做参数接收、格式校验、调用Service，真正业务逻辑写在Service层。事务注解直接打在Service方法上，例如“申报提交并生成审核记录”这种多步操作，不写事务会导致半成功状态。一个典型的例子：提交项目时要同时更新项目状态表、写一条操作日志、可能还要给指导老师发站内信，这三件套必须在一个事务里，否则项目状态变了自己却追不到卡在哪个环节。
权限控制上，用Spring Security加JWT的方案是最常见的。登录接口发token，前端每次请求在header里带Bearer token，拦截器解析token并塞进用户上下文。角色用后端硬编码或者数据库字典管理，不要只靠前端路由判断有没有权限，否则有人手动改控制台就能绕过。至少做一个自定义注解，例如@PreAuthorize("hasAnyRole('ADMIN','REVIEWER')")，在关键接口上做角色校验。
2.2 前端：Vue的页面路由与状态管理
Vue这边的页面结构，新手最容易写成一堆页面互相跳转，状态传参全靠URL。这在小项目里能跑，但在管理端会很难受。我做的版本是典型的组件化思路：路由表按角色和权限拆成懒加载，菜单通过数据驱动生成，而不是每个页面单独裸写。
页面至少要有：登录页、参赛者的工作台（申报、我的项目、材料上传）、审核人的审核列表、评委的打分页、管理员的用户管理、项目管理、路演安排、成绩导出。每个页面都拆成表格组件加弹窗表单组件，数据请求统一封装在api目录下，用axios发请求，拦截器统一处理token过期和错误码，减少重复代码。
状态管理方面，选Vuex还是Pinia？Vue 3项目当然用Pinia，API简洁、体积小，和Composition API配合得特别好。主要存三样东西：用户信息、登录token、当前选中的菜单路由。用户信息在页面刷新后要恢复，所以最好同步存一份localStorage，刷新时再读出来塞进store。不要试图把所有接口数据都放store里，服务端数据库才是唯一数据源，前端store只做缓存和全局状态，否则刷新页面就断片。
路由守卫要写明白：没登录的统一踢到登录页，登录了的踢到默认首页，角色不匹配的踢到403页面。这块别嫌麻烦，答辩演示的时候如果被评委发现直接输URL能进后台，场面相当难看。
Vue版本和构建工具也要留个心眼。如果用的是Vite，要求Node.js版本不能太老，建议用16.15以上。很多人卡在npm install这一步，多半是Node版本太低或者registry源是国外的，换成taobao源基本秒装。
2.3 数据库：MySQL表结构设计与关系建模
数据库是整个系统的地基。我先列几张核心表，大家感受一下粒度。
用户表user：核心字段是id、username、password（加密存储）、real_name、role、college_id、phone、email。
项目表project：id、user_id（申报人）、project_name、project_type、category、intro、attachments、status、submit_time、created_at。这里project_type要建字典，比如1代表创新训练、2代表创业训练，不要用字符串乱填。
审核记录表review_log：id、project_id、reviewer_id、action（通过/退回）、comment、create_time。这张表一是方便追溯流程，二是防止审核完没有痕迹。
评审打分表score：id、project_id、reviewer_id、criteria_name、score、comment。路演评分往往分好几个维度，例如创新性30分、可行性30分、团队表现20分、社会价值20分，每个维度一行记录，最后汇总加权。
路演安排表schedule：id、project_id、round、group_no、start_time、end_time、room、status。
这几张表通过外键逻辑关联，但物理上不要真建外键约束。原因很现实：大并发下外键会影响性能，插入和更新时有约束检查开销，而且一旦业务上要做逻辑删除、历史数据留痕，物理外键非常碍事。在Service层用代码保证数据的引用完整性，多写几个校验就行。
索引设计上，高频查询字段必须加索引。例如project表里status和user_id是最常用的查询条件，status是区分度很低的字段，联合索引(user_id, status)比单独建两个索引更合适。submit_time也可以加索引，因为成绩导出经常按时间区间过滤。不要无脑给所有字段加索引，物极必反，写操作会变慢。
3. 运行环境准备与上手启动
3.1 环境清单：JDK、Node、MySQL、IDE
这个系统既然标注了“可直接运行”，那就得把前置环境说清楚，否则一个源码包扔给别人，别人都不知道怎么下手。
后端需要：JDK 1.8或JDK 11都行，我用的是JDK 8，配合SpringBoot 2.7.14没有任何毛病。Maven建议用3.6以上，通过IDEA自带的Maven就可以。
前端需要：Node.js 16及以上，npm或者yarn随意，但项目里锁定了package-lock.json，用npm更稳妥。
数据库需要：MySQL 5.7或8.0。这里有个实测经验：MySQL 8.0的认证插件是caching_sha2_password，旧版数据库驱动可能连不上，所以如果用8.0，确保pom.xml里mysql-connector-java的版本是8.0.x，并且在连接url上加上useSSL=false和allowPublicKeyRetrieval=true。MySQL 5.7.44是我最近推荐的，稳定、安装简单、占用低，跑这类系统毫无压力。
IDE方面，后端用IDEA，前端也可以用IDEA打开，或者用WebStorm。IDEA社区版做Vue前端稍微弱一点，但写后端、改前端两种活都能干，我个人的习惯是IDEA一个窗口搞定全栈，省得来回切。
3.2 一键式配置与启动步骤（含参数说明）
先说后端。拿到源码后，用IDEA打开，等待Maven把依赖全部拉完。然后找到application.yml文件，重点改数据库配置：
spring: datasource: url: jdbc:mysql://localhost:3306/innovation?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: trueddl-auto用update，系统启动时会自动创建表结构和初始化基础数据，这是“可直接运行”的关键所在。如果你用的是没有带sql文件的源码，这种方式最省事。如果源码带的是xxx.sql文件，那就用Navicat或者命令行先执行sql初始化，再把ddl-auto改成none或validate，避免自动改表。
后端启动非常简单，运行SpringBootApplication的main方法就行。启动日志里看到“Tomcat started on port(s): 8080”，就是成功了。注意端口有没有被占用，如果8080被占，可以在application.yml里改成server.port=8081。
再说前端。打开cmd，cd到vue目录，依次执行：
npm install npm run servenpm install如果卡住，多半是网络问题：
npm config set registry https://registry.npmmirror.com装完后npm run serve，默认会在localhost:80xx跑起来，Vite的默认端口是5173，vue-cli是8080。如果前端端口和后端不一样，注意前端src文件夹下有个request.js或者api.js，里面配置的baseURL必须对应后端地址，例如http://localhost:8080/api，跨域问题如果没开代理，建议在后端写个CorsConfig放行所有来源，走得快。
前后端联调最笨但最有效的方法：启动后端，启动前端，打开浏览器开发者工具，看Network面板有没有红色报错。看报错是网络层还是后端逻辑层，基本上自己就能定位。
3.3 前端构建与后端联调的常见坑
联调这关我能讲一堆血泪。重点提三个高频问题。
第一个是跨域。浏览器直接拿前端去请求后端，如果后端没配CORS，必然报blocked by CORS policy。解决方案有二：一是在后端加全局CORS配置，二是在Vite的vite.config.js里配proxy代理。用proxy更优雅，请求都打到前端端口，再由Vite转发到后端：
server: { proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } }但这样有个前提，request.js里baseURL要写成'/api'，不要写全路径。
第二个是文件上传大小限制。双创系统里PDF、图片上传很频繁，SpringBoot默认单次请求大小只有1MB，传几页课件都可能超限。要在application.yml里放开：
spring: servlet: multipart: max-file-size: 20MB max-request-size: 50MB不然前端传文件传一半，后端直接抛MaxUploadSizeExceededException，前端一直卡在“上传中”，很折磨人。
第三个是本地图片和上传文件访问路径。文件如果存在本地磁盘，例如D:/upload/，一定要配置静态资源映射，否则前端拿不到图片。常见做法是这样：
@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/files/**") .addResourceHandler("file:D:/upload/"); } }这样前端访问http://localhost:8080/files/xxx.pdf，才能把上传的PDF在浏览器里打开预览，否则404。
4. 常见问题与排查技巧实录
4.1 SpringBoot版本太高引发的兼容问题
这个标题下面的问题是真遇到过的。有同学图省事，用Spring Initializr生成项目时默认选了最新版本，结果SpringBoot 3.2配老一套编辑器，页面和接口各种看不懂。比如SpringBoot 3.x把javax包改成jakarta包，你要是从老教程里复制代码，import javax.servlet就会被标红，项目跑不起来。
实测下来，这类竞赛管理系统用SpringBoot 2.7.6是真的稳，配合mybatis-spring-boot-starter 2.3.x或者spring-boot-starter-data-jpa都舒服。如果你拿到的源码本身是SpringBoot 2.x，但是IDEA里默认SDK是8，那就让Maven按pom里的版本下载，不要擅自升3.x。如果pom.xml里已经引了3.x，但代码是旧的javax，那就把3.x改成2.7.x。改完版本号要马上重新reload Maven，否则本地仓库没有对应依赖就跑不起来。
还有数据访问上面的怪问题：SpringBoot 2.7.14升到2.7.18后，MySQL驱动版本也要留意。驱动版本过低会提示Public Key Retrieval is not allowed，这就是前面说的allowPublicKeyRetrieval=true要加上的原因，不然每次连数据库后台登录都失败。
4.2 Vue项目依赖安装与tsconfig报错排查
Vue前端最常见的拦路虎就是装依赖。以Vite创建的Vue3项目为例，package.json里如果配的是TypeScript环境，很多人一打开项目就报：
Failed to load tsconfig '@vue/tsconfig/tsconfig.web.json': tsconfig not found这个报错的根源在于node_modules没装好，或者某个依赖版本错乱。我处理过好几次，解决方案固定三步：第一，删除node_modules和package-lock.json；第二，npm install重新装；第三，npm run dev再启动。如果还是报，检查vue-tsc版本，最好用和项目脚手架一致的版本，避免自己单独升级vue-tsc把类型检查搞挂了。
另外，如果项目是用vue-cli创建的，Node版本太新反而容易出问题，cl快20这种老工具和Node 18以上的EOL警告、OpenSSL冲突频繁出现。这时用nvm先切到Node 16，然后npm install，基本就顺了。
前端跑起来了但页面白屏、路由跳不过去，这也常见。先查控制台有没有“Uncaught TypeError”这类js报错，有的话多半是第三方组件库版本和Vue版本不匹配。比如Element Plus必须配Vue 3，Element UI必须配Vue 2，混着用就页面渲染崩掉。这类管理系统前端，建议就用项目本来的组件库版本，别手痒去升级，升级一时爽，排查火葬场。
4.3 MySQL安装配置与数据库访问故障
MySQL的坑集中在两个阶段：装的时候和连的时候。我第一次装MySQL 8.0在Windows 10上，怎么都起不来，后来发现是服务启动类型没设置成自动，初始化后要手动去“服务”里把MySQL80启动。很多同学拿到的教程只给了安装步骤，没讲怎么验证服务状态，导致连不上的时候以为是代码问题。
MySQL 5.7.44的安装过程相对省心，选择的组件要勾上MySQL Server和MySQL Workbench，别只装Server不装客户端。装的时候会让你设置root密码，这个密码一定拿小本本记好，后面系统要用的就是它。装完验证：
mysql -u root -p输入密码能进mysql提示符，就算装好了。
用Navicat或者IDEA自带数据库工具连接时，如果报“Access denied for user 'root'@'localhost'”，大概率是密码输错了，或者root账户只允许localhost登录。如果你是远程连服务器的MySQL，需要创建一个允许远程访问的用户：
CREATE USER 'appuser'@'%' IDENTIFIED BY 'YourPassword'; GRANT ALL PRIVILEGES ON innovation.* TO 'appuser'@'%'; FLUSH PRIVILEGES;然后application.yml改成appuser账号。
还有动不动就报“Connection refused”，先ping通服务器、telnet 3306端口通不通，多半是防火墙没放行或者MySQL只绑定了127.0.0.1。在my.cnf里把bind-address改成0.0.0.0再重启服务，远程连接就通了。这套系统的运行如果只在本机演示，那就不用折腾这些，专心把前端跑起来就行。
再补一个数据库初始化的建议。手头源码如果带了init.sql，记得先执行再启动后端，别等后端自己建表。自动建表虽然省事，但如果你手欠改过表结构，和代码里Entity字段对不上，JPA启动会直接报Schema-validation: missing table的错。带SQL文件的项目，我把ddl-auto改成none，稳定优先。
我个人的建议是，拿到这类源码，第一件事先把数据库初始化跑通，第二件事把后端跑起来看日志，第三件事把前端跑起来看页面，三个步骤任何一个卡住，就对照错误信息回到环境配置去检查，不要盲目改业务代码。大部分所谓“源码跑不起来”的问题，翻来覆去都是环境问题，真正代码缺漏反而少见。
这套系统后续如果要扩展，我建议优先做两件事：一是给项目附件加上OSS存储，避免本地磁盘扛不住体积；二是把成绩统计输出做成图表，ECharts直接接接口数据，演示效果会明显高一个档次。但这些都是后话，先把基础版本跑起来再说，任何系统能稳定运行，就已经比一半的失败项目走得更远。
