## 1. 项目概述 校园科技竞赛网站是基于SpringBoot框架开发的B/S架构系统主要服务于高校师生参与各类科技竞赛活动。作为一个全栈项目它涵盖了前端展示、后台管理、数据库设计、系统部署等完整开发流程采用当前主流的Java技术栈实现。 我最近刚完成一个类似项目的交付发现这类系统通常需要解决三个核心问题多角色权限管理学生/教师/评委、竞赛流程数字化报名-提交-评审-公示、以及高并发场景下的稳定性。本系统通过SpringBoot的模块化设计很好地平衡了这些需求。 ## 2. 技术架构解析 ### 2.1 核心框架选型 **SpringBoot 2.7.x** 作为基础框架相比传统SSM架构具备以下优势 - 内嵌Tomcat服务器默认9.0版本 - 自动配置starter依赖 - Actuator监控端点 - 与MyBatis无缝集成 xml !-- 典型POM依赖示例 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency2.2 数据库设计采用MySQL 8.0关系型数据库主要表结构包括表名核心字段说明user_infoid, username, password, role_type用户基础信息competitionid, name, start_time, end_time竞赛基本信息submissionid, user_id, file_path, score作品提交记录judge_resultid, submission_id, comment评委评审结果-- 建表示例 CREATE TABLE competition ( id int NOT NULL AUTO_INCREMENT, name varchar(100) NOT NULL, description text, start_time datetime DEFAULT NULL, end_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;2.3 前端技术栈Thymeleaf模板引擎服务端渲染LayUI前端框架简化DOM操作ECharts数据可视化用于数据统计展示3. 关键功能实现3.1 多角色权限控制采用Spring Security实现RBAC模型Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/admin/**).hasRole(ADMIN) .antMatchers(/judge/**).hasRole(JUDGE) .antMatchers(/student/**).hasRole(STUDENT) .anyRequest().authenticated() .and() .formLogin().loginPage(/login); } }3.2 文件上传模块PostMapping(/upload) public String handleFileUpload(RequestParam(file) MultipartFile file) { String uploadDir /var/competition/uploads/; String fileName System.currentTimeMillis() _ file.getOriginalFilename(); try { File dest new File(uploadDir fileName); file.transferTo(dest); return 上传成功 fileName; } catch (IOException e) { return 上传失败 e.getMessage(); } }3.3 评审流程状态机定义竞赛作品的状态流转stateDiagram [*] -- PENDING PENDING -- UNDER_REVIEW : 管理员分配评委 UNDER_REVIEW -- APPROVED : 评分≥60 UNDER_REVIEW -- REJECTED : 评分60 APPROVED -- PUBLISHED : 公示期结束4. 部署实践4.1 开发环境配置JDK 1.8Maven 3.6MySQL 8.0IntelliJ IDEA推荐# 初始化数据库 mysql -u root -p schema.sql # 启动应用 mvn spring-boot:run4.2 生产环境部署方案一传统部署# 打包 mvn clean package -DskipTests # 运行 java -jar target/competition-system-1.0.0.jar \ --server.port8080 \ --spring.datasource.urljdbc:mysql://prod-db:3306/competition方案二Docker部署FROM openjdk:8-jdk-alpine COPY target/*.jar app.jar ENTRYPOINT [java,-jar,/app.jar]5. 常见问题排查5.1 数据库连接失败现象启动时报Communications link failure解决方案检查MySQL用户权限确认连接字符串格式jdbc:mysql://host:port/db?useSSLfalseserverTimezoneAsia/Shanghai5.2 文件上传权限问题现象Linux系统上报Permission denied处理步骤chmod 755 /var/competition chown -R springboot:springboot /var/competition5.3 性能优化建议添加Redis缓存热门数据配置Tomcat连接池参数spring.datasource.hikari.maximum-pool-size20 server.tomcat.max-threads2006. 源码结构说明src/ ├── main/ │ ├── java/ │ │ └── com/ │ │ └── competition/ │ │ ├── config/ # 配置类 │ │ ├── controller/ # 控制器 │ │ ├── entity/ # 实体类 │ │ ├── mapper/ # MyBatis接口 │ │ ├── service/ # 业务逻辑 │ │ └── CompetitionApplication.java │ └── resources/ │ ├── static/ # 静态资源 │ ├── templates/ # 视图模板 │ ├── application.yml # 主配置文件 │ └── mybatis-config.xml # MyBatis配置 └── test/ # 测试代码提示实际开发中建议添加Swagger文档支持便于接口调试dependency groupIdio.springfox/groupId artifactIdspringfox-boot-starter/artifactId version3.0.0/version /dependency我在部署这类系统时有个实用技巧使用Nginx做静态资源代理和负载均衡可以显著提升性能。典型配置如下server { listen 80; server_name competition.example.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; } location ~* \.(js|css|png)$ { root /var/competition/static; expires 30d; } }对于需要处理高并发的场景建议将文件存储迁移到OSS服务数据库考虑读写分离架构。这些扩展方案可以根据实际用户规模逐步实施。