简介：这是一套面向高校计算机相关专业学生与JavaEE初学者、可用于课程设计或毕业设计的学生信息管理系统完整项目，采用JavaEE技术栈，整合SSH框架与SQL Server数据库，覆盖学生、教师、管理员三类角色的信息维护与登录权限管理。压缩包共487个文件，约20.9MB，包含jsp页面、java源码、class编译文件、jar依赖包、css与js前端资源、xml及properties配置、数据库db文件，以及gif、jpg、png等界面素材和ppt、doc说明文档，结构完整，便于直接导入运行与二次开发。资源已有781人学习下载，配套源码与文档经过测试校正，可稳定运行。读者可据此掌握SSH分层架构、DAO与Action设计、分页工具类及数据库连接配置等关键实现，快速搭建环境、理解业务逻辑，并在此基础上完成功能扩展与论文撰写，适合作为课程实践与毕设参考。

1. 从一份能跑通的 SSH 学生信息管理系统说起

如果你手头正好有一套基于 JavaEE + SSH + SQL Server 的学生信息管理系统源码，却卡在“导入 IDE 报红、连不上库、登录 500”的阶段，那这篇笔记就是写给你的。SSH 在这里不是远程登录那个 ssh，而是 Struts2 + Spring + Hibernate 三个框架的合称，配合 SQL Server 做持久化，是很多高校课程设计和早期企业后台的经典组合。这套资源的定位很明确：一套带完整源码和配套文档的学生信息管理系统，覆盖学生档案、成绩录入、班级管理、用户权限这几块后台最常见的业务。它适合两类人——一类是要交课程设计、需要一份能跑起来能讲清楚的作品；另一类是刚接触 SSH 整合、想找一个真实分层项目练手的开发者。下面我按“先跑起来、再拆结构、最后避坑”的顺序，把这份资源从环境到代码讲透。

2. 环境搭建：JDK、Tomcat 与 SQL Server 的版本咬合

SSH 这套技术栈对版本相当敏感，尤其是 Struts2 和 Hibernate 的 jar 包，差一个小版本就可能出现NoSuchMethodError。所以第一步不是急着导入项目，而是把运行环境钉死。我一般会先确认三件事：JDK 用哪个版本、Tomcat 用哪个版本、SQL Server 用哪个版本，这三者决定了后面 80% 的玄学问题。

2.1 JDK 与 Tomcat 的选型理由

这套 SSH 项目通常基于 JDK 1.7 或 1.8 编译，Spring 3.x/4.x 配 Hibernate 3.x/4.x 是主流。JDK 建议直接用 1.8，兼容性最好，别上 11 或 17，老版本 Struts2 在模块化之后反射会出问题。Tomcat 选 7 或 8，Tomcat 9 之后对部分老 API 有调整，容易在启动时抛ClassNotFoundException。

安装完 JDK 后配置环境变量，Windows 下验证：

java -version javac -version

两条命令输出的版本号必须一致，不一致说明 PATH 里混了多个 JDK，这是后面编译报错的常见源头。Tomcat 解压后不用装，直接改conf/server.xml里的端口，避免和已占用端口冲突：

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

端口改成 8080 以外的值，比如 8081，改完启动bin/startup.bat，浏览器访问http://localhost:8081能看到 Tomcat 首页就说明容器没问题。

2.2 SQL Server 的安装与实例配置

SQL Server 这块是新手翻车最集中的地方。常见做法是装 SQL Server 2012 或 2019 的 Developer 版，安装时记住实例名，默认实例是MSSQLSERVER，命名实例类似SQLEXPRESS。安装完成后必须做两件事：开启 TCP/IP 协议、开启 SQL Server 身份验证模式。

开启 TCP/IP 的路径是：SQL Server 配置管理器 → SQL Server 网络配置 → 实例的协议 → TCP/IP 右键启用，然后重启 SQL Server 服务。不开这一步，Java 通过 JDBC 连库时会报Connection refused，而用 SSMS 本地却能连上，这个反差最容易让人懵。

身份验证模式在 SSMS 里右键服务器 → 属性 → 安全性 → 选“SQL Server 和 Windows 身份验证模式”，然后重启服务。接着建一个登录名，比如sa或者自定义账号，给db_owner权限。验证连接：

SELECT @@VERSION; SELECT name FROM sys.databases;

第一条看版本，第二条看当前实例下有哪些库。能查出结果说明实例和账号都正常。

2.3 JDBC 驱动与连接串的对应关系

SQL Server 的 JDBC 驱动版本要和数据库版本匹配。SQL Server 2012 及以上用mssql-jdbc-7.x或8.x，更老的 2008 用sqljdbc4.jar。驱动放错版本，典型报错是The driver could not establish a secure connection或者直接ClassNotFoundException: com.microsoft.sqlserver.jdbc.SQLServerDriver。

连接串写法：

jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver jdbc.url=jdbc:sqlserver://localhost:1433;DatabaseName=StudentMS;encrypt=false jdbc.username=sa jdbc.password=你的密码

encrypt=false这一项在较新驱动里必须显式加上，否则默认开启加密会握手失败。DatabaseName换成你实际导入的库名。端口 1433 是默认值，如果你装的时候改过，这里要同步改。把这段配置写进 Spring 的applicationContext.xml或者jdbc.properties，具体看项目用的是哪种加载方式。

3. 源码结构拆解：SSH 三层怎么串起来

环境通了之后，重点转向代码本身。SSH 整合的核心是“Struts2 管请求、Spring 管对象、Hibernate 管持久化”，三者通过配置文件粘在一起。看懂这套结构，你才能改功能、加模块，而不是只会跑。

3.1 Struts2 的 Action 与结果映射

Struts2 负责把浏览器请求分发到 Action 类。项目里通常有一个struts.xml，里面按模块配置 action：

<package name="student" extends="struts-default" namespace="/student"> <action name="list" class="studentAction" method="list"> <result name="success">/WEB-INF/jsp/student/list.jsp</result> <result name="input">/WEB-INF/jsp/student/form.jsp</result> </action> </package>

class属性的值studentAction不是类名，而是 Spring 容器里的 bean id，这就是 SSH 整合的关键点——Action 的实例化交给 Spring 管理。method指定调用 Action 里的哪个方法，result决定返回哪个 JSP。访问路径就是命名空间/action名，比如/student/list.action。

这里有个容易忽略的点：Struts2 的 action 默认是多例的，每次请求新建实例，所以 Action 里不要写有状态的成员变量，否则并发下数据会串。

3.2 Spring 的依赖注入与事务配置

Spring 在这套架构里干两件事：管理 bean、声明事务。applicationContext.xml里会看到数据源、SessionFactory、DAO、Service、Action 的逐层注入：

<bean id="studentAction" class="com.demo.action.StudentAction" scope="prototype"> <property name="studentService" ref="studentService"/> </bean> <bean id="studentService" class="com.demo.service.impl.StudentServiceImpl"> <property name="studentDao" ref="studentDao"/> </bean> <bean id="studentDao" class="com.demo.dao.impl.StudentDaoImpl"> <property name="sessionFactory" ref="sessionFactory"/> </bean>

Action 的scope必须是prototype，因为 Struts2 每次请求要新实例；Service 和 DAO 用默认的singleton就行。事务一般配在 Service 层，用 AOP 切面：

<tx:advice id="txAdvice" transaction-manager="transactionManager"> <tx:attributes> <tx:method name="add*" propagation="REQUIRED"/> <tx:method name="update*" propagation="REQUIRED"/> <tx:method name="delete*" propagation="REQUIRED"/> <tx:method name="get*" read-only="true"/> </tx:attributes> </tx:advice>

方法名以add/update/delete开头的走写事务，get开头的走只读事务。如果你新加的方法不符合这个命名规则，事务不会生效，这是“明明改了数据却没提交”的典型原因。

3.3 Hibernate 映射文件与实体类

Hibernate 负责对象和表的映射。项目里每个实体对应一个.hbm.xml文件，或者用注解。以学生表为例：

<class name="com.demo.entity.Student" table="t_student"> <id name="id" column="id"> <generator class="native"/> </id> <property name="name" column="name" type="string"/> <property name="studentNo" column="student_no" type="string"/> <many-to-one name="clazz" column="class_id" class="com.demo.entity.Clazz"/> </class>

generator class="native"表示主键由数据库自增策略决定，SQL Server 下会走 identity。many-to-one是学生和班级的多对一关系，column是外键列名。实体类里的属性名要和name一致，否则启动时报PropertyNotFoundException。

Hibernate 的hibernate.cfg.xml或者 Spring 里的 SessionFactory 配置要指定方言：

hibernate.dialect=org.hibernate.dialect.SQLServerDialect hibernate.show_sql=true hibernate.format_sql=true

方言写错，分页查询会生成错误的 SQL，SQL Server 用的是top而不是limit，这个差异在翻页功能上特别明显。

4. 数据库导入与首次登录：从建库到跑通首页

代码结构清楚了，接下来把数据库和系统对接上。这一步的目标是：导入 SQL 脚本、改好连接配置、启动 Tomcat、用默认账号登录进首页。

4.1 建库与执行 SQL 脚本

资源里一般会带一个.sql文件，里面是建表语句和初始数据。在 SSMS 里新建查询，先建库再执行脚本：

CREATE DATABASE StudentMS; GO USE StudentMS; GO -- 然后打开资源里的 sql 文件，全选执行

执行完检查表是否齐全：

SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE='BASE TABLE';

常见的表有t_student、t_class、t_score、t_user这几张。如果脚本里用了GO批处理分隔符，注意在 SSMS 里执行没问题，但用 JDBC 批量执行会报错，所以导入阶段用 SSMS 最稳。

4.2 修改配置文件并部署

把项目导入 Eclipse 或 IDEA 后，找到数据库配置文件，把用户名密码改成你本地的。然后确认struts.xml、applicationContext.xml、web.xml三个文件都在src或WEB-INF下正确位置。web.xml里要有 Struts2 的过滤器和 Spring 的监听器：

<listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class> </filter>

监听器负责启动时加载 Spring 容器，过滤器负责拦截请求交给 Struts2。少任何一个，要么 bean 注入失败，要么请求 404。

部署方式是把项目打成 war 放进 Tomcat 的webapps，或者在 IDE 里配置 Tomcat 服务器直接运行。启动后看控制台，没有Exception且出现Server startup in xxx ms就算成功。

4.3 默认账号登录与首页验证

浏览器访问http://localhost:8081/项目名/，一般会跳到登录页。默认账号密码通常在 SQL 脚本的t_user表里，常见的是admin/123456或admin/admin。登录成功后应该能看到学生列表或后台首页。

如果登录报 500，先看控制台堆栈。最高频的两个原因：一是数据库连不上，堆栈里有SQLServerException；二是 Action 没注入成功，堆栈里有NullPointerException指向 Service 调用。前者回去查连接串和 TCP/IP，后者查 Spring 配置里 Action 的 bean id 是否和struts.xml里的class一致。

5. 避坑排查：SSH + SQL Server 最常见的五类翻车

这一章是我自己踩过、也帮别人定位过的真实问题，按“现象 → 原因 → 解决”整理，遇到报错可以直接对号入座。

5.1 启动报 ClassNotFoundException: com.microsoft.sqlserver.jdbc.SQLServerDriver

现象：Tomcat 启动或首次连库时抛这个异常，系统直接起不来。

原因：JDBC 驱动 jar 没放进WEB-INF/lib，或者放进去但版本和连接串里的类名不匹配。老驱动类名是com.microsoft.jdbc.sqlserver.SQLServerDriver，新驱动才是com.microsoft.sqlserver.jdbc.SQLServerDriver。

解决：确认WEB-INF/lib下有mssql-jdbc-*.jar，并且配置文件里的jdbc.driver写的是新类名。如果项目用的是 Maven，检查pom.xml里依赖的 scope 是不是provided，是的话打包不会带进去。

5.2 登录后查询列表报 Invalid object name 't_student'

现象：能登录，但一进学生列表就报 SQL 错误，提示表名无效。

原因：Hibernate 映射里的表名和数据库实际表名不一致，或者连接串里的DatabaseName指向了错误的库。

解决：先在 SSMS 里确认表在哪个库、叫什么名字，然后对照.hbm.xml里的table属性。如果数据库里是Student而映射写的是t_student，改任意一边保持一致即可。另外确认连接串里的库名和建库时一致。

5.3 中文乱码：页面显示问号或数据库存进去是乱码

现象：JSP 页面中文正常，但提交到数据库变成???，或者从库里读出来是乱码。

原因：三个环节的编码不统一——JSP 页面编码、Struts2 请求编码、数据库排序规则。

解决：JSP 顶部加<%@ page contentType="text/html;charset=UTF-8" %>；struts.xml里配<constant name="struts.i18n.encoding" value="UTF-8"/>；数据库建库时排序规则选Chinese_PRC_CI_AS。三处都统一成 UTF-8 相关设置，乱码基本消失。

5.4 事务不生效：数据改了但没进库

现象：执行新增或修改，页面提示成功，但数据库里没变化。

原因：Service 方法名不符合事务切面里配的命名规则，比如配的是add*，你写的方法叫insertStudent，切面匹配不上。

解决：要么把方法名改成addStudent，要么在tx:attributes里补一条<tx:method name="insert*" propagation="REQUIRED"/>。改完重启，再测一次。

5.5 Tomcat 端口占用导致启动失败

现象：启动时报Address already in use: JVM_Bind，Tomcat 起不来。

原因：8080 端口被其他程序占用，常见的是另一个 Tomcat 实例或者某个开发工具。

解决：netstat -ano | findstr 8080找到占用进程的 PID，任务管理器结束它，或者把 Tomcat 的Connector port改成 8081 等空闲端口。改完记得同步改访问地址。

6. 二次开发技巧：加一个成绩统计模块的完整路径

跑通之后，多数人下一步是想加点自己的功能，比如按班级统计平均分。这一章给一条可复制的开发路径，从实体到页面走一遍，你照着就能扩展出别的模块。

6.1 从实体到 DAO 的增量开发

假设要加一个“班级平均分”查询，先想清楚数据从哪来。成绩在t_score表，班级在t_class，学生关联两者。最省事的做法是不新建表，直接写一个聚合查询。

在 DAO 层加方法：

public List<Object[]> getClassAvgScore() { String hql = "select s.clazz.name, avg(s.score) from Score s group by s.clazz.name"; return getHibernateTemplate().find(hql); }

HQL 里Score是实体类名不是表名，s.clazz.name走的是多对一关联。返回的是Object[]列表，每个元素是班级名和平均分。这种聚合查询不需要改映射文件，适合快速验证。

6.2 Service 与 Action 的串联

Service 层包一层，加上事务只读：

public List<Object[]> getClassAvgScore() { return scoreDao.getClassAvgScore(); }

Action 里接收结果放到 request：

public String avgScore() { List<Object[]> list = scoreService.getClassAvgScore(); ActionContext.getContext().put("avgList", list); return "success"; }

struts.xml里加一个 action 映射，result 指向新的 JSP。JSP 里用 JSTL 遍历：

<c:forEach items="${avgList}" var="row"> <tr><td>${row[0]}</td><td>${row[1]}</td></tr> </c:forEach>

row[0]是班级名，row[1]是平均分。整条链路走完，你就有了一个不依赖新表的统计功能。

6.3 验证与调试习惯

改完代码别急着全量重启，先看控制台有没有 HQL 语法错误。Hibernate 开了show_sql之后会把生成的 SQL 打出来，复制到 SSMS 里单独执行，能快速判断是 HQL 写错还是数据本身有问题。

我自己的习惯是：每次加新功能，先在 SSMS 里把目标 SQL 写对，再翻译成 HQL，最后接 Action 和 JSP。这样出问题时能明确是查询逻辑错还是框架配置错，不用在整条链路上瞎猜。从那以后我每次扩展模块都强制走一遍“SQL 先行”的流程，省下的排查时间比写代码还多。希望这套学生信息管理系统的拆解能帮你少走几个弯路。

本文还有配套的精品资源，点击获取