企业官网建设流程全解析

很多学生拿到类似“大学生创新项目管理系统”这种题目时，第一反应往往是先去GitHub找个开源项目改一改。但如果你真打算把它当毕设或者课设写，我建议还是亲手从零搭一遍。原因很简单：答辩时老师真正关心的不是你“用了多新的框架”，而是你能不能把一条完整的数据流讲清楚，能不能说得出“为什么这层要这样设计”。SSM + JSP + Bootstrap这套组合虽然听起来有点“老”，但它恰好把JavaWeb最核心的东西都串起来了，而且市面上资料多、坑也基本都被踩平了，非常适合作为这类管理系统的落地选型。

这篇东西我按自己实际做一个“大学生创新项目管理系统”的思路来写，从技术选型的考量、环境准备、数据库设计、核心功能实现，到开发中踩过的一堆坑，尽量把能复用的经验都放出来。准备开工的可以直接照着搭，已经做了一半的也可以对比一下自己的实现有没有遗漏。

1. 为什么选SSM + JSP + Bootstrap而不是Spring Boot + Vue

先说个容易被杠的问题：都什么年代了，新项目还用SSM + JSP？我理解Spring Boot + Vue确实开发效率高，前后端分离也是主流。但放到“大学生创新项目管理系统”这个具体场景里，SSM + JSP这套组合有它不可替代的合理性，尤其对于课程设计和毕业设计来说。

第一，教学体系兼容性。国内大多数高校的JavaWeb课程顺序是：Servlet -> JSP -> SSM，最后才碰Spring Boot。如果你直接上Spring Boot + Vue，等于跳过了学校考核的核心知识点。答辩时老师让你讲“SpringMVC的请求流程是怎样的”，你可能只能干瞪眼。第二，JSP在这个系统里并不算落后，它最适合的就是“后台管理类”页面——表单提交、表格展示、条件查询，这类交互不需要复杂的页面状态管理，服务端渲染反而直观。第三，部署简单。一个Tomcat扔上去就能跑，不需要像前后端分离那样还得配Nginx、处理跨域。

当然这套组合也有明显短板：前端资源打包、静态文件管理都比较原始，并发能力一般。但一个院级项目管理系统，日活用户撑死几百人，SSM绰绰有余。选型这件事，从来不是“越新越好”，而是“够用且你能说清楚”。所以如果你正在纠结技术栈，我建议别犹豫，SSM + JSP可以放心用。后端是Spring + SpringMVC + MyBatis，前端是Bootstrap负责样式和简单交互，JSP做服务端页面渲染，Maven管理依赖和构建，MySQL存数据。这个组合的每一个环节都有明确的存在意义。

2. 环境搭建与项目骨架：Maven、MySQL和IDEA的配置要点

2.1 从零创建Maven工程

新建项目我推荐直接用IDEA的Maven骨架，选择org.apache.maven.archetypes:maven-archetype-webapp，这个骨架会帮你生成标准的webapp目录。别迷信网上那些所谓“万能骨架”，官方骨架虽然结构简单，但所有文件你都能控制，出问题也容易排查。

关键是要在pom.xml里把依赖一次配齐。SSM项目有一个经典问题：依赖版本不兼容。我用下来最稳的一套版本搭配是下面这些，你可以直接复制过去，省掉很多对版本的时间：

<properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <spring.version>5.3.23</spring.version> </properties> <dependencies> <!-- spring核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- mybatis与spring整合 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.11</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.7</version> </dependency> <!-- mysql驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> </dependency> <!-- 连接池 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.12</version> </dependency> <!-- servlet/jsp相关 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>taglibs</groupId> <artifactId>standard</artifactId> <version>1.1.2</version> </dependency> </dependencies>

这里有个很容易踩的雷：javax.servlet-api必须声明<scope>provided</scope>。因为Tomcat自带了Servlet容器实现，如果你不声明provided，打包后的WAR会把Servlet API也打进去，部署到Tomcat时反而可能因为版本冲突报错。

2.2 MySQL安装与库表初始化

MySQL的安装教程网上一搜一大把，我只提醒三个实操点。第一，下载时看清楚版本，8.0以上和5.7的驱动配置有区别。如果你用8.0，JDBC驱动类要写com.mysql.cj.jdbc.Driver，并且在连接URL上必须追加时区参数。第二，安装完成后第一时间用命令行验证服务是否启动，Windows下可以用：

net start mysql mysql -u root -p

如果提示服务名无效，先在“服务”管理器里确认MySQL的服务名称，不同安装方式生成的名称不一样，可能是mysql80或者MySQL。第三，建库时统一用UTF-8，避免后面对中文乱码问题，推荐直接在创建数据库时指定：

CREATE DATABASE IF NOT EXISTS innovation_project DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

一个常见问题是很多人忘了utf8mb4和utf8的区别。utf8最多存3字节，遇到生僻字或者部分中文符号会存不进去，utf8mb4完全兼容utf8且支持4字节字符。用utf8mb4不是为了好看，是为了少给自己找麻烦。

数据库连接配置放在jdbc.properties里，主要注意时区和编码：

jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/innovation_project?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true jdbc.username=root jdbc.password=你的密码

allowPublicKeyRetrieval=true这个参数是MySQL 8.0特有的，不加的话用某些客户端连接时会报Public Key Retrieval is not allowed，我之前在这上面耗了不少时间。

2.3 SSM三大配置文件怎么组织

SSM整合的核心是三个配置文件：spring.xml（容器配置）、springmvc.xml（MVC配置）和mybatis-config.xml（MyBatis配置）。我的习惯是：

• spring.xml管理数据源、事务、Service层扫描，同时也把MyBatis的SqlSessionFactory和MapperScannerConfigurer配置在这里，这样Mapper代理对象才能注入Service。
• springmvc.xml只扫Controller层，配置视图解析器、静态资源放行和注解驱动。
• mybatis-config.xml放MyBatis全局设置，比如下划线转驼峰、日志输出。

这里必须注意一个初学者最容易犯的错误：<context:component-scan>在spring.xml里如果扫描了com.xxx.controller包，会导致Controller被Spring容器重复管理，事务和MVC的AOP关系全乱。我的处理方式是Spring容器里只扫service和dao，Controller单独交给SpringMVC管。

事务配置建议直接用注解驱动，在spring.xml里加上：

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <tx:annotation-driven transaction-manager="transactionManager"/>

然后在Service实现类或者具体的业务方法上加上@Transactional。注意事务只对RuntimeException回滚，如果你在代码里catch掉异常又不往外抛，事务不会生效。

3. 创新项目管理系统的数据库设计：从立项到结题的数据流

3.1 核心表结构与字段规划

做管理系统，数据库设计决定了后面开发是顺畅还是痛苦。我设计这套系统时把数据分成了六大块：用户、项目申报、评审过程、中期检查、结题、角色权限。权力不要散，每一种数据都要有明确的归属。

先看用户表。一个常见的错误是只建一张表，通过type字段区分学生、教师、管理员。我初期也这么干，但后来发现三个角色拥有的字段差别太大——学生要学号和班级，教师要职称和研究方向，管理员是院系归属。所以最终拆成了三张用户表，用公共字段user_id关联。别怕表多，逻辑清晰比表少更重要。

项目申报表是整个系统的核心，我设计的字段如下：

这里要特别说明member_ids字段。一开始我犹豫要不要建一个项目成员关联表，后来因为成员数量固定（一般2-5人），用逗号分隔存的方案更简单，查询时直接用FIND_IN_SET或者拆字符串。虽然不满足第三范式，但这类规模的项目里，过度范式化反而增加无谓的关联查询。如果你追求更严谨的设计，可以拆成project_member表，这个自己权衡。

评审表和中期检查表比较类似。评审表存专家意见和评分，中期检查表存项目进展、资金使用情况，两张表都通过project_id外键关联到项目表。还有一个容易被忽略的是“状态变更日志表”。学生提交申报、老师审核、提交中期材料、管理员结题，每一步都是一次状态流转。专门建一张project_log表记录这些流转，既能回溯问题，答辩时也能展示出你对“可追溯性”的思考，这是亮点。

3.2 角色权限与状态机的设计思路

这个系统里一共有三种角色：学生、指导教师、院系管理员。它们的本质区别不在“能登录哪些页面”，而在“能对项目做什么操作”。

• 学生：创建项目、提交申报、编辑项目资料、提交中期报告、提交结题申请、查看审核意见。
• 教师：审批项目申报、查看自己指导的项目列表、填写审批意见、查看中期报告并评分。
• 管理员：维护用户信息、分配指导教师、查看所有项目、设置申报时间窗口、导出项目汇总。

状态机是这个系统的灵魂。我画不出图，但你心里必须有一条线：草稿 -> 待指导审核 -> 待管理员复审 -> 已立项 -> 中期检查 -> 结题申报 -> 已结题。每一步都对应一个status值，前端按钮根据status决定显示“提交”“审核”还是“修改”。这种设计的好处是业务逻辑全部收敛在Service层，Controller只负责转发参数，页面只负责展示。

3.3 数据库索引与查询优化

表建完不等于完事，索引要跟上。project表的student_id和teacher_id是高频查询条件，必须建索引。project_log表的project_id外键也一定要建。我见过很多人的系统后期数据量其实不大，但页面查询奇慢无比，多半是索引缺失或者SQL里写了%xxx%这种前置模糊查询。前置模糊查询会导致索引失效：

-- 这样写会导致索引失效 SELECT * FROM project WHERE project_name LIKE '%创新%'; -- 应该写成这样 SELECT * FROM project WHERE project_name LIKE '创新%';

如果确实需要前方模糊匹配，可以后续引入全文索引或者搜索引擎，这种规模的管理系统用不到，知道有这个问题就够了。

4. 核心功能实现与页面开发：登录、审批流和JSP列表页

4.1 登录与拦截器的实现

登录模块我用的经典方案：Session存储登录用户，拦截器做访问控制。不要用简单的if判断代替拦截器，否则每个Controller方法里都要重复写一套“检查用户是否为空”的逻辑，项目一多必然漏。

拦截器的实现分成两步。第一步注册拦截器，配置放行路径；第二步编写拦截逻辑。注册可以在springmvc.xml里完成：

<mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/static/**"/> <mvc:exclude-mapping path="/register"/> <mvc:exclude-mapping path="/captcha"/> <bean class="com.example.interceptor.LoginInterceptor"/> </mvc:interceptor> </mvc:interceptors>

拦截器类则要区分静态资源和登录状态。JSP页面经常会引用CSS、JS和图片，这些路径如果不放行，会一直重定向到登录页，这也是一个很隐蔽的坑：

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 如果是静态资源，直接放行 String uri = request.getRequestURI(); if (uri.startsWith(request.getContextPath() + "/static/")) { return true; } // 检查登录状态 Object user = request.getSession().getAttribute("user"); if (user == null) { response.sendRedirect(request.getContextPath() + "/login"); return false; } return true; }

密码存储建议用MD5加盐或者BCrypt，别用明文。虽然管理系统里没有特别敏感的支付数据，但大学生的学号和手机号也算个人信息，安全习惯从这种小项目里养起来，以后工作不吃亏。

4.2 项目申报与审批的核心Service逻辑

学生提交申报，这里有一个“事务边界”问题。一次申报涉及的操作包括：插入project表、更新学生的“是否已有未完成项目”状态、写一条project_log日志。这三步必须在一个事务里，否则可能出现项目提交成功但日志丢失的情况。

我的实现思路是Service层定义完整流程，Controller只做参数组装：

@Service public class ProjectServiceImpl implements ProjectService { @Transactional(rollbackFor = Exception.class) @Override public void submitProject(Project project, Long studentId) { // 1. 校验该学生是否已有进行中的项目 int count = projectMapper.countActiveByStudent(studentId); if (count > 0) { throw new BusinessException("你已有进行中的项目，不能重复申报"); } // 2. 插入项目，初始状态为草稿 project.setStatus(ProjectStatus.DRAFT.getValue()); projectMapper.insert(project); // 3. 记录日志 projectLogMapper.insert(ProjectLog.builder() .projectId(project.getProjectId()) .operatorId(studentId) .action("申报") .comment("学生提交创新项目申报") .build()); } }

审批流程里要注意“并发重复审核”问题。理论上两个老师同时打开同一个项目页面提交审核，后覆盖前。解决思路很粗暴：在project表的status字段上加乐观锁版本号，或者在审核前先执行一条带条件的UPDATE：

UPDATE project SET status = #{targetStatus}, audit_time = NOW() WHERE project_id = #{projectId} AND status = #{expectStatus}

如果影响行数为0，说明状态已被其他人修改，就直接返回“操作失败，项目状态已更新，请刷新后重试”。这道防线虽然简单，但能让你在答辩时放在“系统健壮性”里讲，比单纯增删改查有说服力得多。

4.3 JSP页面列表展示：Bootstrap表格与分页

JSP页面我推荐用JSTL + EL表达式做数据渲染，核心是避免在JSP里写大量<% %>脚本。脚本片段会导致页面难以维护，而且看起来极其不专业。列表页的结构通常是这样：

<table class="table table-bordered table-hover"> <thead> <tr> <th>项目名称</th> <th>负责人</th> <th>指导教师</th> <th>状态</th> <th>操作</th> </tr> </thead> <tbody> <c:forEach items="${pageInfo.list}" var="item"> <tr> <td>${item.projectName}</td> <td>${item.leaderName}</td> <td>${item.teacherName}</td> <td><span class="badge ${item.statusClass}">${item.statusText}</span></td> <td> <a href="${pageContext.request.contextPath}/project/detail?id=${item.projectId}" class="btn btn-sm btn-info">详情</a> <c:if test="${sessionScope.user.role == 'teacher' && item.status == 1}"> <a href="${pageContext.request.contextPath}/project/audit?id=${item.projectId}" class="btn btn-sm btn-success">审核</a> </c:if> </td> </tr> </c:forEach> </tbody> </table>

分页用PageHelper插件是目前最省事的方案，不需要自己写limit拼接。在pom.xml引入依赖然后在mybatis-config.xml里配置插件即可。分页查询时，Service层直接调用：

PageHelper.startPage(pageNum, pageSize); List<ProjectVO> list = projectMapper.selectProjectList(condition); PageInfo<ProjectVO> pageInfo = new PageInfo<>(list);

这里有一个必须注意的坑：PageHelper.startPage只能紧跟查询语句，如果你在startPage和selectProjectList之间加了其它SQL操作，分页就可能错乱或者失效。很多人第一次用PageHelper遇到分页不生效都查不出原因，多半就是这个顺序乱了。

Bootstrap在这套系统里的作用是把表单和表格的样式拉齐，减少写CSS的时间。比如Modal弹窗做审核意见录入、日期选择器做项目时间设置，都是Bootstrap生态里的成熟组件。别贪多，一个管理系统Bootstrap足够撑起全部前端交互了。

5. 阶段复盘：这些坑我是一步一步踩过来的

这部分内容来源是我的真实经历。按重要程度挑几个有代表性的说，新手最容易卡住的往往就是这些问题。

5.1 Maven依赖冲突与“找不到符号”

最常见的是servlet-api冲突。Tomcat自己带了一套Servlet实现，如果你的项目里又显式引入了另一个版本的servlet-api且没加scope=provided，部署时就会报NoClassDefFoundError或者方法签名对不上。排查思路是：

mvn dependency:tree > deps.txt

打开deps.txt找是否有多个servlet-api、jsp-api、jstl条目，然后把冗余的依赖用<exclusions>排除掉。另一个典型的是Spring包的自动升级，我在一开始固定Spring版本为5.3.23就是这个原因，否则Maven可能会把不同版本的spring-core和spring-webmvc解析到一起，运行时报抽象方法错误。

5.2 修改JSP不生效

这是一个特别容易让人崩溃的问题。改完JSP刷新浏览器还是旧页面，原因基本都在IDEA的Tomcat配置里。默认情况下IDEA部署Web项目到Tomcat是“复制到target目录”，JSP修改后如果你没有重新构建，target下的旧文件不会更新。

解决办法是在IDEA的Tomcat运行配置中，把“On frame deactivation”设为“Update classes and resources”，并且在“Deployment”页面确认是war exploded模式。用这个模式开发，热部署才能生效，否则只能每次重启Tomcat。

5.3 中文乱码的三处源头

中文乱码可能出现在请求参数、数据库读取、页面展示三个环节，逐个排查：

• 页面到Controller的POST参数乱码，在web.xml里配置CharacterEncodingFilter，强制UTF-8。
• 数据库读出来乱码，确认jdbc.url的characterEncoding=utf8参数加没加。
• MySQL本身编码不对，检查安装时的默认字符集是不是utf8mb4。

一个很隐蔽的场景：用GET提交中文参数，Tomcat默认对URL参数用的编码是ISO-8859-1，需要在server.xml的Connector节点加上URIEncoding="UTF-8"：

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />

5.4 SpringMVC的JPQL与MyBatis的#{}和${}选择

MyBatis写SQL时，#{}是预编译占位符，${}是字符串拼接。传参数尽可能用#{}，这能防止SQL注入。但有些场景不用${}不行，比如动态排序字段名、动态表名。我的原则是：值一律用#{}，只有无法避免的字段名/排序字段才用${}，且这些值必须来自后端白名单校验，不能直接拿前端参数拼。

5.5 异步请求与JSP的JSON乱斗

评论或者审核时会用fetch提交JSON数据。SpringMVC接收JSON需要@RequestBody，同时要保证Jackson依赖在项目中，并且SpringMVC配置了<mvc:annotation-driven/>。有一次我把JSON请求发过去一直报415，检查后发现问题在于请求头的Content-Type写错了。前端用fetch的时候一定要显式设置：

fetch(ctx + '/project/audit', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ id: projectId, approve: true, comment: '同意' }) })

5.6 权限与前端按钮闪现问题

记住一个原则：前端控制按钮显隐只是体验优化，真正的权限控制必须发生在后端。千万不要因为某个角色在JSP页面上看不到某个按钮，就认为它无法调用对应的Controller接口。一个熟悉接口地址的学生完全可以绕过前端直接POST。所以Service层做操作前必须再次校验当前会话用户的角色。

5.7 数据备份与恢复

开发过程中数据库被自己玩炸是常有的事。我建议从第一天就用Maven插件或命令行定期备份，别等答辩前一天才想起来：

mysqldump -u root -p innovation_project > backup_$(date +%Y%m%d).sql

恢复也很简单：

mysql -u root -p innovation_project < backup_20250101.sql

6. 从开发到上线：项目部署与后续扩展

很多人开发的系统在IDEA里跑得好好的，一到部署就翻车。部署这件事情在我看来有几个关键点值得提前交代。

第一，打包方式。用Maven的package命令打成WAR包，放到Tomcat的webapps目录下。注意如果你的项目名和WAR包名不一致，访问路径会有差异。我习惯在pom.xml里设置<finalName>innovation</finalName>，这样部署后访问路径就是http://localhost:8080/innovation/，简单好记。

第二，生产环境和开发环境的配置要分离。数据库密码、服务器地址不要写死在jdbc.properties里再打入WAR包，我吃过这个亏。比较省力的做法是用Maven Profile，配置dev和prod两套环境，打包时通过-P prod参数选择对应的配置文件。这样换环境部署不用改代码，只需要重新打包。

第三，日志别忽视。SSM项目里至少要把Spring、MyBatis、SpringMVC三套日志输出到文件。我习惯用Log4j2，并且按天滚动。这样出现问题能快速定位，而不是事后拍脑袋猜。MyBatis的SQL日志在开发期打开，上线后记得关掉，不然控制台会被SQL刷屏。

关于扩展方向，这套系统其实可以玩出很多花样。如果你想在答辩时展示一些进阶能力，可以考虑这几个点：用ECharts把项目立项数量、结题率做成可视化报表；加入消息通知机制，学生在项目状态变化时收到站内信；用Spring Task定时关闭申报窗口，自动更新项目状态。只要是基于当前SSM架构的增量开发，都不会太违和。

最后分享一个我的个人习惯：在每个Service方法上都写一行注释说明业务边界，在每个状态流转的地方写清楚“从哪个状态到哪个状态”。一开始是觉得答辩需要逻辑自洽，后来发现对维护也有用。这个项目做完，你收获的绝对不止一个管理系统，而是对“一条请求从页面到数据库再回到页面”的完整心智模型。这套东西放在以后的任何框架里都不过时。