简介这套社会保险管理系统是一个基于 SSM 框架与 JSP 技术的完整 Java Web 项目资源面向计算机专业学生和开发人员特别适合作为毕业设计、课程设计或框架整合练手的参考项目。系统围绕社保日常业务划分为六个核心模块参保人员档案管理负责单位、在职、退休和已故员工档案的增删改查保险金缴纳管理完成缴费审核、入账与补缴保险金发放管理处理退休待遇核定、入账以及已故员工补助发放信息查询、信息发布与系统维护模块将档案、缴费、发放等数据串联起来形成完整的业务闭环整体设计贴合实际社保管理流程。压缩包约 24.47MB内含可运行源码、SQL 数据库脚本和配套说明文档三类文件分类清晰导入开发工具后执行数据库脚本即可快速部署运行。目前已有 1839 人学习下载可用于理解 SSM 分层架构、JSP 页面交互和业务模块设计也能支撑二次开发与毕业设计文档的撰写。1. 这套SSM JSP社保系统是什么、解决什么、谁能直接用提前领到一份ssm jsp源码的同学打开压缩包第一眼往往是三样东西后端Java代码、前端JSP页面、还有一份数据库SQL。这套社会保险管理系统就是这类源码包的典型代表——它把社会保险业务拆成参保者档案管理、保险金缴纳管理、保险金发放管理、信息查询、信息发布、系统维护六个模块配合MySQL落库Spring SpringMVC MyBatis接管后端。它能解决的问题很直接毕业设计或课程设计需要一套能演示增删改查、带业务流程、有完整页面和数据库的系统而你不需要再从零搭框架、造数据。适合刚开始做管理系统的在校学生也适合想快速看SSM三层怎么协作的转行开发者。下面按一线工程师拆包的顺序把架构、表结构、核心模块、部署和踩坑整个过一遍。2. 先看架构SSM分层协作与六张核心业务表2.1 为什么这套项目偏爱SSM三元组SSM组合在高校项目里出场率极高不是因为它是最新最潮的技术而是它的分工足够清晰Spring容器负责管理Service、Mapper这些BeanSpringMVC把浏览器请求映射到Controller方法MyBatis把SQL和Java对象做映射。放在这套社保系统里JSP负责最终展示配合EL表达式和JSTL标签就能把后台数据渲染成表格。这个组合对初学者的友好之处在于每一层都能独立看。拿「参保者档案管理」来说浏览器点新增员工URL先到ControllerController调Service查重和落库Service再通过Mapper把数据写到employee表。哪个环节出了问题顺着这条链排查比那些动辄前后端分离、中间还要经过网关的工程直白得多。也要认清这套技术栈的边界JSP页面渲染偏重前端逻辑和后端代码耦合在同一个Web应用里页面改动要重新编译部署。这决定了它的定位是把业务闭环讲清楚而不是生产级高并发系统。对毕业答辩来说评审老师关心的恰恰是能不能完整讲出这套调用链以及数据库字段设计是否符合业务直觉。2.2 六张核心表的设计与建表SQL对照系统的六个模块我把源码里的核心表整理成了下面的对应关系。实际项目里可能还有操作日志表、权限表这类辅助表但主线逻辑都落在下面这六张。表名对应模块关键字段company单位档案管理单位编号、单位名称、单位性质、地址employee人员档案管理员工编号、姓名、身份证号、单位ID、员工状态insurance_pay保险金缴纳管理缴费周期、单位ID、平均工资、人数、缴费金额、缴费状态insurance_grant保险金发放管理员工ID、发放类型、发放金额、发放状态notice信息发布公告标题、公告内容、发布时间sys_user系统维护用户名、密码、真实姓名建表SQL里值得注意的不是表多而是状态字段怎么表达。员工状态如果直接存在职退休已故这样的字符串查询和统计都要写一堆字符串比较。源码里用的是TINYINT状态码我在下面节选了employee、insurance_pay、insurance_grant三张核心表的建表语句。CREATE DATABASE IF NOT EXISTS social_security_db DEFAULT CHARACTER SET utf8mb4; USE social_security_db; CREATE TABLE employee ( id INT PRIMARY KEY AUTO_INCREMENT, emp_no VARCHAR(50) NOT NULL UNIQUE COMMENT 员工编号, emp_name VARCHAR(30) NOT NULL COMMENT 姓名, id_card VARCHAR(18) COMMENT 身份证号, company_id INT NOT NULL COMMENT 所属单位ID, emp_state TINYINT NOT NULL DEFAULT 1 COMMENT 员工状态1在职 2退休 3已故, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_company_id (company_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE insurance_pay ( id INT PRIMARY KEY AUTO_INCREMENT, company_id INT NOT NULL COMMENT 缴费单位ID, pay_period VARCHAR(20) NOT NULL COMMENT 缴费周期如2025-03, avg_wage DECIMAL(10,2) NOT NULL COMMENT 当月员工平均工资, employee_count INT NOT NULL COMMENT 参保人数, total_amount DECIMAL(12,2) NOT NULL COMMENT 应缴总金额, pay_status TINYINT NOT NULL DEFAULT 0 COMMENT 缴费状态0待审核 1已入账 2已补缴, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE insurance_grant ( id INT PRIMARY KEY AUTO_INCREMENT, employee_id INT NOT NULL COMMENT 领取员工ID, grant_type TINYINT NOT NULL COMMENT 发放类型1退休金 2丧葬补助, grant_amount DECIMAL(12,2) NOT NULL COMMENT 发放金额, grant_status TINYINT NOT NULL DEFAULT 0 COMMENT 发放状态0待审核 1已入账, grant_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这种建表方式有几个好处。金额字段用DECIMAL而不是FLOAT或DOUBLE是财务数据的老规矩——浮点类型在累加和比较时会有精度误差DECIMAL按定点数存储在对账场景下更稳。pay_status和grant_status默认0对应状态机里的待审核初始态后面做审核入账操作时Service层只要判断当前状态是不是0就能防止重复入账。需要注意employee里的emp_no字段用了UNIQUE约束员工编号作为业务主键参与跨表引用。实际开发中我一般会让ID做物理主键、emp_no做业务唯一键这样既满足删除维护时的索引效率又保证业务上不出现重复员工。很多初学项目在这里只建主键不加唯一约束结果演示时插入两条相同编号的数据查询和缴费统计直接乱套。2.3 配置上最关键的几根线拿到源码先别急着看业务代码SSM项目启动不起来八成是配置文件里的线没接对。这套项目里最核心的配置集中在两处web.xml和Spring的XML配置。web.xml里注册DispatcherServlet并配置编码过滤器保证请求能进SpringMVC同时让POST提交的中文不乱码。filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mappingCharacterEncodingFilter必须放在所有过滤器的最前面url-pattern写成/*才能把静态资源请求也覆盖到。DispatcherServlet的url-pattern写成/表示所有请求都进SpringMVC这时静态CSS、JS、图片也需要在spring-mvc.xml里配置放行否则页面样式加载不出来。Spring的XML配置里大方向是component-scan扫Controller和ServiceSqlSessionFactoryBean注册MyBatisMapperScannerConfigurer扫描Mapper接口。我见过不少同学把MapperScannerConfigurer漏配了运行时报Invalid bound statement其实就是接口和XML映射没被装配进去。配置文件顺序不要随意调整MyBatis的SqlSessionFactory必须先于Mapper扫描器初始化。3. 核心模块复现档案CRUD与缴费发放状态流转3.1 档案管理一个Controller怎么把增删改查串起来参保者档案管理这一块是标准的CRUD但它的业务细节比学生管理系统多一层员工有在职、退休、已故三种状态删除员工不能把历史缴费记录一起物理删掉。看源码里的EmployeeController请求路径设计得很直观。Controller RequestMapping(/employee) public class EmployeeController { Autowired private EmployeeService employeeService; RequestMapping(/list) public String list(RequestParam(required false) String empName, RequestParam(required false) Integer empState, Model model) { EmployeeQuery query new EmployeeQuery(); query.setEmpName(empName); query.setEmpState(empState); model.addAttribute(page, employeeService.queryPage(query)); return employee/list; } RequestMapping(/save) public String save(Employee employee, RedirectAttributes attr) { employeeService.saveOrUpdate(employee); attr.addFlashAttribute(msg, 保存成功); return redirect:/employee/list; } RequestMapping(/delete/{id}) public String delete(PathVariable Integer id) { employeeService.deleteById(id); return redirect:/employee/list; } }这段代码的核心逻辑在参数绑定方式。RequestParam(required false)让查询接口的empName和empState都可选列表页不带任何参数时直接返回全量分页数据带了姓名就做模糊匹配带了状态就做精确筛选。save方法里的RedirectAttributes是防止表单重复提交的关键——保存成功后重定向到list接口浏览器地址栏变成/employee/list刷新页面只会重新查询不会再次触发保存。Service层在删除这个方法上做了状态保护。我的习惯是员工只要名下存在缴费记录或发放记录一律不做物理删除而是把emp_state改成3已故保留历史流水。这套源码里deleteById也采用了类似思路Controller层面看不出差别但数据不会因为删除操作而凭空消失。做二次开发的同学可以在EmployeeService里加一个判断先统计insurance_pay和insurance_grant里有没有该员工的记录有则返回提示请先处理该员工的缴费/发放记录。3.2 缴费与发放状态机审核的核心Service写法缴费管理和发放管理是这套系统的业务重心也是最容易被讲师追问的地方。设计上用了同一种模式待审核状态0入账状态1补缴状态2。下面这段auditPay方法展示了缴费审核的事务写法。Service public class InsurancePayServiceImpl implements InsurancePayService { Autowired private InsurancePayMapper payMapper; Autowired private PayLogMapper payLogMapper; Transactional(rollbackFor Exception.class) public void auditPay(Integer payId, Integer operatorId) { InsurancePay pay payMapper.selectById(payId); if (pay null) { throw new RuntimeException(缴费记录不存在); } if (pay.getPayStatus() ! 0) { throw new RuntimeException(当前状态不可审核); } // 审核通过后置为已入账并写入一条操作日志 pay.setPayStatus(1); payMapper.updateStatus(pay); PayLog log new PayLog(); log.setPayId(payId); log.setOperatorId(operatorId); log.setOperateTime(new Date()); payLogMapper.insert(log); } }Transactional保证updateStatus和insert日志要么同时成功要么同时回滚。审核操作一旦入账状态从0变成1再调用这个方法就会在状态校验处被拦下来。补缴场景在源码里的做法是重新生成一条缴费记录pay_period沿用原周期pay_status直接置为2这样能区分正常缴费和补缴两个动作对账时也清晰。发放管理的Service层比缴费多了业务条件校验。比如发放类型为丧葬补助时必须先确认员工状态是已故发放退休金前确认员工状态是退休。这个判断不放在Controller里因为Controller只做参数接收真正的业务规则必须收敛到Service两个不同的Controller入口调同一个Service方法时不会绕过校验。Transactional(rollbackFor Exception.class) public void grantToEmployee(Integer employeeId, BigDecimal amount, Integer grantType) { Employee emp employeeMapper.selectById(employeeId); if (emp null) { throw new RuntimeException(员工不存在); } if (grantType 2 emp.getEmpState() ! 3) { throw new RuntimeException(丧葬补助仅限已故员工); } if (grantType 1 emp.getEmpState() ! 2) { throw new RuntimeException(退休金仅限退休员工); } InsuranceGrant grant new InsuranceGrant(); grant.setEmployeeId(employeeId); grant.setGrantAmount(amount); grant.setGrantType(grantType); grant.setGrantStatus(0); grantMapper.insert(grant); }这里有一个容易被忽视的参数设计grant_amount用BigDecimal接收页面传入金额而不是String或double。前端表单如果传3500.50SpringMVC会自动把字符串转成BigDecimal如果传了空值或非数字字符会触发类型转换异常提示也更明确。后续做金额计算时直接用BigDecimal的add、multiply方法不要转double再操作。3.3 信息查询与发布动态SQL解决多条件查询信息查询模块汇总了档案查询、单位缴费情况查询、个人账户查询、死亡及遗属档案查询。这些查询的共性问题是条件不固定可能只按姓名查也可能按姓名加状态加单位三个条件一起查。MyBatis里的动态SQL在这一块价值最明显。select idqueryPage parameterTypeEmployeeQuery resultTypeEmployee SELECT e.*, c.company_name FROM employee e LEFT JOIN company c ON e.company_id c.id where if testempName ! null and empName ! AND e.emp_name LIKE CONCAT(%, #{empName}, %) /if if testempState ! null AND e.emp_state #{empState} /if if testcompanyId ! null AND e.company_id #{companyId} /if /where ORDER BY e.id DESC /select标签会自动处理AND前缀——当第一个条件成立时标签不会在SQL开头多出一个AND当所有条件都不成立时整个WHERE子句自动消失返回全表分页。LIKE拼接用CONCAT函数而不是直接在XML里写LIKE %${empName}%区别在于#{}是预编译占位符${}是字符串拼接后者存在SQL注入风险。信息发布模块在源码里就是一张notice表的增删改查加一个发布时间字段控制排序。前台首页拉取最近五条公告时按create_time倒序排列再用LIMIT限制条数。这个模块业务量不大但它是系统里唯一面向所有用户展示的信息出口做得完整对答辩演示有加分效果——登录前后首页展示的公告列表是评委看得见的功能点。4. 部署与避坑从SQL导入到Tomcat运行的六个高频翻车点4.1 标准部署流程源码包里的SQL文件与数据库连接配置是配套的但第一次跑通仍然需要按固定顺序走。我的顺序是先建库导数据再改连接配置最后启动Tomcat。mysql -uroot -p social_security_db.sql导入前先确认本机MySQL的root密码和字符集。连接配置集中在jdbc.properties文件里这个文件在部署时是必改项。jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/social_security_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你自己的密码jdbc.url里的characterEncodingutf8必须保留并且与SQL脚本建库时的utf8mb4保持一致。useSSLfalse是因为本地开发库一般没有配置SSL证书不加这个参数高版本MySQL连接器会频繁报SSL警告。密码如果包含特殊字符注意不要被properties文件的等号分隔逻辑截断。Tomcat部署部分源码包如果自带lib目录直接把整个Web项目目录拷到Tomcat的webapps下启动Tomcat后通过http://localhost:8080/项目名 访问。用IntelliJ IDEA的话更常见的做法是在Run Configuration里添加Tomcat ServerDeployment选war exploded模式这样改JSP页面不用重新打war包刷新浏览器就能看到效果。启动后先看日志有没有异常堆栈再看浏览器能不能正常打开登录页。注意导入SQL时如果报错说数据库已存在先执行DROP DATABASE再重新导入。多次导同一份脚本会在重复的表定义上报错这种情况与代码无关属于重复初始化问题。4.2 五条血泪踩坑记录第一坑启动报Access denied for user rootlocalhost。现象是Tomcat启动日志里出现数据库连接异常页面访问直接500。原因是jdbc.properties里的密码和本机MySQL实际密码不一致或者MySQL里root账号不允许本地连接。解决方法是先用命令行工具验证root能否正常登录然后把jdbc.password改成正确值改完重启Tomcat不要只刷新页面。第二坑JSP页面中文字符全部显示为问号。现象是页面标题、按钮文字都是乱码或者问号但后台日志正常。原因基本是三层没对齐SQL脚本建库时不是utf8mb4、jdbc.url少加characterEncodingutf8、或JSP页面没有声明UTF-8编码。解决方法是同时检查这三处统一改成UTF-8。这个坑最常见于直接用文本编辑器打开SQL脚本导入而脚本文件本身是UTF-8保存的导入工具默认用了别的编码。第三坑访问Controller路径返回404但静态页面能打开。现象是点某个菜单后Tomcat报404控制台也没有进入Controller的日志。原因是DispatcherServlet拦截了所有请求但component-scan没有扫描到Controller所在的包或者spring-mvc.xml里的视图解析器前缀路径配错导致JSP页面找不到。解决方法是检查spring-mvc.xml的context:component-scan base-packagecom.xxx.controller/与实际Controller包路径是否一致再检查InternalResourceViewResolver的prefix是否指向WEB-INF/views。第四坑MyBatis报Invalid bound statement (not found)。现象是一调用Mapper接口方法就抛异常提示找不到某个id对应的SQL。原因是Mapper接口的namespace和Mapper XML的namespace不一致或者XML文件没有放在Mapper接口同包的目录下。解决方法是打开Mapper XML确认namespace全限定名与接口路径完全一致并且XML里每个select/insert/update标签的id与接口方法名相同。第五坑Tomcat端口被占用启动直接失败。现象是控制台提示Port 8080 already in use项目无法启动。原因是本机有另一个进程占用了8080。解决方法是打开Tomcat的conf/server.xml把HTTP端口改成8081改完后访问地址也要对应调整。还有一种情况是前一次部署没正常关闭Java进程还挂着Windows下可以在任务管理器结束对应进程Linux下用ps -ef | grep java找到进程kill掉再重启。5. 从交作业到答辩演示顺序与三个实用二次开发点源码跑通只是第一步真正能让这个项目在答辩现场站住脚的是演示顺序和几个锦上添花的改动。我建议演示时不要从登录页开始平铺直叙地讲而是先切入员工档案管理录一条在职员工、一条退休员工让评审看到新增和状态变化接着立刻演示缴费审核把刚才录入的员工所属单位做一笔应缴记录展示从待审核到已入账的过程。这样前后业务是连贯的比一个个菜单点过去有说服力得多。二次开发优先级最高的是补缴记录标志。源码里缴费状态的补缴和入账都通过字段区分但页面列表上最好增加一个颜色或标签来区分比如已补缴显示橙色标签。改动很小只要在JSP里判断pay_status的值不同值渲染不同class即可。第二个值得做的是导出Excel。答辩老师经常问能不能把缴费记录导出来用POI写一个简单的导出接口就够了。RequestMapping(/export) public void export(HttpServletRequest request, HttpServletResponse response) throws IOException { ListInsurancePay list payService.queryAll(); response.setContentType(application/vnd.ms-excel;charsetUTF-8); response.setHeader(Content-Disposition, attachment;filenamepay.xls); try (Workbook workbook new HSSFWorkbook()) { Sheet sheet workbook.createSheet(缴费记录); // 首行创建标题后续每行写入pay_period、total_amount、pay_state字段 for (int i 0; i list.size(); i) { Row row sheet.createRow(i 1); row.createCell(0).setCellValue(list.get(i).getPayPeriod()); row.createCell(1).setCellValue(list.get(i).getTotalAmount().doubleValue()); row.createCell(2).setCellValue(getPayStatusText(list.get(i).getPayStatus())); } workbook.write(response.getOutputStream()); } }这段代码把查询结果直接写入Excel响应流money字段转成double写入时注意精确度展示用途可以接受。如果改成小数点后两位需要设置单元格格式。第三个改动是把公告发布页的纯文本编辑器换成简单的富文本或者至少支持换行显示。源码里如果公告内容存的是长文本JSP页面默认会丢失换行可以用一个JSTL函数把换行符替换成br标签。演示验证清单我一般会提前走一遍管理员登录是否正常录入一条档案后列表能否立即刷新缴费审核后状态是否从待审核变成已入账退休员工能否成功领取退休金已故员工申请丧葬补助时能否正常通过以及一台没装过MySQL的机器能不能用自己的环境把这套流程完整复现。每一步都跑通心里才有底。这套系统我拆过不止一次最大的教训是拿到任何源码包都先跑通再动代码而不是一上来就想着改页面对接自己的创意功能。曾经为了改一个菜单名称直接改了数据库字段结果整套关联查询全部失效最后重新导库才救回来。从那以后我每次拿到这类项目都强制走一遍全流程导库、连接、启动、核心业务验证数据库脚本永远先备份再动刀。希望这套SSM社保系统的部署和改法能帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/22 19:26:49 · 阅读 1.2k SSM框架JSP社保管理系统：架构设计、核心模块与部署避坑指南
简介这套社会保险管理系统是一个基于 SSM 框架与 JSP 技术的完整 Java Web 项目资源面向计算机专业学生和开发人员特别适合作为毕业设计、课程设计或框架整合练手的参考项目。系统围绕社保日常业务划分为六个核心模块参保人员档案管理负责单位、在职、退休和已故员工档案的增删改查保险金缴纳管理完成缴费审核、入账与补缴保险金发放管理处理退休待遇核定、入账以及已故员工补助发放信息查询、信息发布与系统维护模块将档案、缴费、发放等数据串联起来形成完整的业务闭环整体设计贴合实际社保管理流程。压缩包约 24.47MB内含可运行源码、SQL 数据库脚本和配套说明文档三类文件分类清晰导入开发工具后执行数据库脚本即可快速部署运行。目前已有 1839 人学习下载可用于理解 SSM 分层架构、JSP 页面交互和业务模块设计也能支撑二次开发与毕业设计文档的撰写。1. 这套SSM JSP社保系统是什么、解决什么、谁能直接用提前领到一份ssm jsp源码的同学打开压缩包第一眼往往是三样东西后端Java代码、前端JSP页面、还有一份数据库SQL。这套社会保险管理系统就是这类源码包的典型代表——它把社会保险业务拆成参保者档案管理、保险金缴纳管理、保险金发放管理、信息查询、信息发布、系统维护六个模块配合MySQL落库Spring SpringMVC MyBatis接管后端。它能解决的问题很直接毕业设计或课程设计需要一套能演示增删改查、带业务流程、有完整页面和数据库的系统而你不需要再从零搭框架、造数据。适合刚开始做管理系统的在校学生也适合想快速看SSM三层怎么协作的转行开发者。下面按一线工程师拆包的顺序把架构、表结构、核心模块、部署和踩坑整个过一遍。2. 先看架构SSM分层协作与六张核心业务表2.1 为什么这套项目偏爱SSM三元组SSM组合在高校项目里出场率极高不是因为它是最新最潮的技术而是它的分工足够清晰Spring容器负责管理Service、Mapper这些BeanSpringMVC把浏览器请求映射到Controller方法MyBatis把SQL和Java对象做映射。放在这套社保系统里JSP负责最终展示配合EL表达式和JSTL标签就能把后台数据渲染成表格。这个组合对初学者的友好之处在于每一层都能独立看。拿「参保者档案管理」来说浏览器点新增员工URL先到ControllerController调Service查重和落库Service再通过Mapper把数据写到employee表。哪个环节出了问题顺着这条链排查比那些动辄前后端分离、中间还要经过网关的工程直白得多。也要认清这套技术栈的边界JSP页面渲染偏重前端逻辑和后端代码耦合在同一个Web应用里页面改动要重新编译部署。这决定了它的定位是把业务闭环讲清楚而不是生产级高并发系统。对毕业答辩来说评审老师关心的恰恰是能不能完整讲出这套调用链以及数据库字段设计是否符合业务直觉。2.2 六张核心表的设计与建表SQL对照系统的六个模块我把源码里的核心表整理成了下面的对应关系。实际项目里可能还有操作日志表、权限表这类辅助表但主线逻辑都落在下面这六张。表名对应模块关键字段company单位档案管理单位编号、单位名称、单位性质、地址employee人员档案管理员工编号、姓名、身份证号、单位ID、员工状态insurance_pay保险金缴纳管理缴费周期、单位ID、平均工资、人数、缴费金额、缴费状态insurance_grant保险金发放管理员工ID、发放类型、发放金额、发放状态notice信息发布公告标题、公告内容、发布时间sys_user系统维护用户名、密码、真实姓名建表SQL里值得注意的不是表多而是状态字段怎么表达。员工状态如果直接存在职退休已故这样的字符串查询和统计都要写一堆字符串比较。源码里用的是TINYINT状态码我在下面节选了employee、insurance_pay、insurance_grant三张核心表的建表语句。CREATE DATABASE IF NOT EXISTS social_security_db DEFAULT CHARACTER SET utf8mb4; USE social_security_db; CREATE TABLE employee ( id INT PRIMARY KEY AUTO_INCREMENT, emp_no VARCHAR(50) NOT NULL UNIQUE COMMENT 员工编号, emp_name VARCHAR(30) NOT NULL COMMENT 姓名, id_card VARCHAR(18) COMMENT 身份证号, company_id INT NOT NULL COMMENT 所属单位ID, emp_state TINYINT NOT NULL DEFAULT 1 COMMENT 员工状态1在职 2退休 3已故, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_company_id (company_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE insurance_pay ( id INT PRIMARY KEY AUTO_INCREMENT, company_id INT NOT NULL COMMENT 缴费单位ID, pay_period VARCHAR(20) NOT NULL COMMENT 缴费周期如2025-03, avg_wage DECIMAL(10,2) NOT NULL COMMENT 当月员工平均工资, employee_count INT NOT NULL COMMENT 参保人数, total_amount DECIMAL(12,2) NOT NULL COMMENT 应缴总金额, pay_status TINYINT NOT NULL DEFAULT 0 COMMENT 缴费状态0待审核 1已入账 2已补缴, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE insurance_grant ( id INT PRIMARY KEY AUTO_INCREMENT, employee_id INT NOT NULL COMMENT 领取员工ID, grant_type TINYINT NOT NULL COMMENT 发放类型1退休金 2丧葬补助, grant_amount DECIMAL(12,2) NOT NULL COMMENT 发放金额, grant_status TINYINT NOT NULL DEFAULT 0 COMMENT 发放状态0待审核 1已入账, grant_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这种建表方式有几个好处。金额字段用DECIMAL而不是FLOAT或DOUBLE是财务数据的老规矩——浮点类型在累加和比较时会有精度误差DECIMAL按定点数存储在对账场景下更稳。pay_status和grant_status默认0对应状态机里的待审核初始态后面做审核入账操作时Service层只要判断当前状态是不是0就能防止重复入账。需要注意employee里的emp_no字段用了UNIQUE约束员工编号作为业务主键参与跨表引用。实际开发中我一般会让ID做物理主键、emp_no做业务唯一键这样既满足删除维护时的索引效率又保证业务上不出现重复员工。很多初学项目在这里只建主键不加唯一约束结果演示时插入两条相同编号的数据查询和缴费统计直接乱套。2.3 配置上最关键的几根线拿到源码先别急着看业务代码SSM项目启动不起来八成是配置文件里的线没接对。这套项目里最核心的配置集中在两处web.xml和Spring的XML配置。web.xml里注册DispatcherServlet并配置编码过滤器保证请求能进SpringMVC同时让POST提交的中文不乱码。filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mappingCharacterEncodingFilter必须放在所有过滤器的最前面url-pattern写成/*才能把静态资源请求也覆盖到。DispatcherServlet的url-pattern写成/表示所有请求都进SpringMVC这时静态CSS、JS、图片也需要在spring-mvc.xml里配置放行否则页面样式加载不出来。Spring的XML配置里大方向是component-scan扫Controller和ServiceSqlSessionFactoryBean注册MyBatisMapperScannerConfigurer扫描Mapper接口。我见过不少同学把MapperScannerConfigurer漏配了运行时报Invalid bound statement其实就是接口和XML映射没被装配进去。配置文件顺序不要随意调整MyBatis的SqlSessionFactory必须先于Mapper扫描器初始化。3. 核心模块复现档案CRUD与缴费发放状态流转3.1 档案管理一个Controller怎么把增删改查串起来参保者档案管理这一块是标准的CRUD但它的业务细节比学生管理系统多一层员工有在职、退休、已故三种状态删除员工不能把历史缴费记录一起物理删掉。看源码里的EmployeeController请求路径设计得很直观。Controller RequestMapping(/employee) public class EmployeeController { Autowired private EmployeeService employeeService; RequestMapping(/list) public String list(RequestParam(required false) String empName, RequestParam(required false) Integer empState, Model model) { EmployeeQuery query new EmployeeQuery(); query.setEmpName(empName); query.setEmpState(empState); model.addAttribute(page, employeeService.queryPage(query)); return employee/list; } RequestMapping(/save) public String save(Employee employee, RedirectAttributes attr) { employeeService.saveOrUpdate(employee); attr.addFlashAttribute(msg, 保存成功); return redirect:/employee/list; } RequestMapping(/delete/{id}) public String delete(PathVariable Integer id) { employeeService.deleteById(id); return redirect:/employee/list; } }这段代码的核心逻辑在参数绑定方式。RequestParam(required false)让查询接口的empName和empState都可选列表页不带任何参数时直接返回全量分页数据带了姓名就做模糊匹配带了状态就做精确筛选。save方法里的RedirectAttributes是防止表单重复提交的关键——保存成功后重定向到list接口浏览器地址栏变成/employee/list刷新页面只会重新查询不会再次触发保存。Service层在删除这个方法上做了状态保护。我的习惯是员工只要名下存在缴费记录或发放记录一律不做物理删除而是把emp_state改成3已故保留历史流水。这套源码里deleteById也采用了类似思路Controller层面看不出差别但数据不会因为删除操作而凭空消失。做二次开发的同学可以在EmployeeService里加一个判断先统计insurance_pay和insurance_grant里有没有该员工的记录有则返回提示请先处理该员工的缴费/发放记录。3.2 缴费与发放状态机审核的核心Service写法缴费管理和发放管理是这套系统的业务重心也是最容易被讲师追问的地方。设计上用了同一种模式待审核状态0入账状态1补缴状态2。下面这段auditPay方法展示了缴费审核的事务写法。Service public class InsurancePayServiceImpl implements InsurancePayService { Autowired private InsurancePayMapper payMapper; Autowired private PayLogMapper payLogMapper; Transactional(rollbackFor Exception.class) public void auditPay(Integer payId, Integer operatorId) { InsurancePay pay payMapper.selectById(payId); if (pay null) { throw new RuntimeException(缴费记录不存在); } if (pay.getPayStatus() ! 0) { throw new RuntimeException(当前状态不可审核); } // 审核通过后置为已入账并写入一条操作日志 pay.setPayStatus(1); payMapper.updateStatus(pay); PayLog log new PayLog(); log.setPayId(payId); log.setOperatorId(operatorId); log.setOperateTime(new Date()); payLogMapper.insert(log); } }Transactional保证updateStatus和insert日志要么同时成功要么同时回滚。审核操作一旦入账状态从0变成1再调用这个方法就会在状态校验处被拦下来。补缴场景在源码里的做法是重新生成一条缴费记录pay_period沿用原周期pay_status直接置为2这样能区分正常缴费和补缴两个动作对账时也清晰。发放管理的Service层比缴费多了业务条件校验。比如发放类型为丧葬补助时必须先确认员工状态是已故发放退休金前确认员工状态是退休。这个判断不放在Controller里因为Controller只做参数接收真正的业务规则必须收敛到Service两个不同的Controller入口调同一个Service方法时不会绕过校验。Transactional(rollbackFor Exception.class) public void grantToEmployee(Integer employeeId, BigDecimal amount, Integer grantType) { Employee emp employeeMapper.selectById(employeeId); if (emp null) { throw new RuntimeException(员工不存在); } if (grantType 2 emp.getEmpState() ! 3) { throw new RuntimeException(丧葬补助仅限已故员工); } if (grantType 1 emp.getEmpState() ! 2) { throw new RuntimeException(退休金仅限退休员工); } InsuranceGrant grant new InsuranceGrant(); grant.setEmployeeId(employeeId); grant.setGrantAmount(amount); grant.setGrantType(grantType); grant.setGrantStatus(0); grantMapper.insert(grant); }这里有一个容易被忽视的参数设计grant_amount用BigDecimal接收页面传入金额而不是String或double。前端表单如果传3500.50SpringMVC会自动把字符串转成BigDecimal如果传了空值或非数字字符会触发类型转换异常提示也更明确。后续做金额计算时直接用BigDecimal的add、multiply方法不要转double再操作。3.3 信息查询与发布动态SQL解决多条件查询信息查询模块汇总了档案查询、单位缴费情况查询、个人账户查询、死亡及遗属档案查询。这些查询的共性问题是条件不固定可能只按姓名查也可能按姓名加状态加单位三个条件一起查。MyBatis里的动态SQL在这一块价值最明显。select idqueryPage parameterTypeEmployeeQuery resultTypeEmployee SELECT e.*, c.company_name FROM employee e LEFT JOIN company c ON e.company_id c.id where if testempName ! null and empName ! AND e.emp_name LIKE CONCAT(%, #{empName}, %) /if if testempState ! null AND e.emp_state #{empState} /if if testcompanyId ! null AND e.company_id #{companyId} /if /where ORDER BY e.id DESC /select标签会自动处理AND前缀——当第一个条件成立时标签不会在SQL开头多出一个AND当所有条件都不成立时整个WHERE子句自动消失返回全表分页。LIKE拼接用CONCAT函数而不是直接在XML里写LIKE %${empName}%区别在于#{}是预编译占位符${}是字符串拼接后者存在SQL注入风险。信息发布模块在源码里就是一张notice表的增删改查加一个发布时间字段控制排序。前台首页拉取最近五条公告时按create_time倒序排列再用LIMIT限制条数。这个模块业务量不大但它是系统里唯一面向所有用户展示的信息出口做得完整对答辩演示有加分效果——登录前后首页展示的公告列表是评委看得见的功能点。4. 部署与避坑从SQL导入到Tomcat运行的六个高频翻车点4.1 标准部署流程源码包里的SQL文件与数据库连接配置是配套的但第一次跑通仍然需要按固定顺序走。我的顺序是先建库导数据再改连接配置最后启动Tomcat。mysql -uroot -p social_security_db.sql导入前先确认本机MySQL的root密码和字符集。连接配置集中在jdbc.properties文件里这个文件在部署时是必改项。jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/social_security_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你自己的密码jdbc.url里的characterEncodingutf8必须保留并且与SQL脚本建库时的utf8mb4保持一致。useSSLfalse是因为本地开发库一般没有配置SSL证书不加这个参数高版本MySQL连接器会频繁报SSL警告。密码如果包含特殊字符注意不要被properties文件的等号分隔逻辑截断。Tomcat部署部分源码包如果自带lib目录直接把整个Web项目目录拷到Tomcat的webapps下启动Tomcat后通过http://localhost:8080/项目名 访问。用IntelliJ IDEA的话更常见的做法是在Run Configuration里添加Tomcat ServerDeployment选war exploded模式这样改JSP页面不用重新打war包刷新浏览器就能看到效果。启动后先看日志有没有异常堆栈再看浏览器能不能正常打开登录页。注意导入SQL时如果报错说数据库已存在先执行DROP DATABASE再重新导入。多次导同一份脚本会在重复的表定义上报错这种情况与代码无关属于重复初始化问题。4.2 五条血泪踩坑记录第一坑启动报Access denied for user rootlocalhost。现象是Tomcat启动日志里出现数据库连接异常页面访问直接500。原因是jdbc.properties里的密码和本机MySQL实际密码不一致或者MySQL里root账号不允许本地连接。解决方法是先用命令行工具验证root能否正常登录然后把jdbc.password改成正确值改完重启Tomcat不要只刷新页面。第二坑JSP页面中文字符全部显示为问号。现象是页面标题、按钮文字都是乱码或者问号但后台日志正常。原因基本是三层没对齐SQL脚本建库时不是utf8mb4、jdbc.url少加characterEncodingutf8、或JSP页面没有声明UTF-8编码。解决方法是同时检查这三处统一改成UTF-8。这个坑最常见于直接用文本编辑器打开SQL脚本导入而脚本文件本身是UTF-8保存的导入工具默认用了别的编码。第三坑访问Controller路径返回404但静态页面能打开。现象是点某个菜单后Tomcat报404控制台也没有进入Controller的日志。原因是DispatcherServlet拦截了所有请求但component-scan没有扫描到Controller所在的包或者spring-mvc.xml里的视图解析器前缀路径配错导致JSP页面找不到。解决方法是检查spring-mvc.xml的context:component-scan base-packagecom.xxx.controller/与实际Controller包路径是否一致再检查InternalResourceViewResolver的prefix是否指向WEB-INF/views。第四坑MyBatis报Invalid bound statement (not found)。现象是一调用Mapper接口方法就抛异常提示找不到某个id对应的SQL。原因是Mapper接口的namespace和Mapper XML的namespace不一致或者XML文件没有放在Mapper接口同包的目录下。解决方法是打开Mapper XML确认namespace全限定名与接口路径完全一致并且XML里每个select/insert/update标签的id与接口方法名相同。第五坑Tomcat端口被占用启动直接失败。现象是控制台提示Port 8080 already in use项目无法启动。原因是本机有另一个进程占用了8080。解决方法是打开Tomcat的conf/server.xml把HTTP端口改成8081改完后访问地址也要对应调整。还有一种情况是前一次部署没正常关闭Java进程还挂着Windows下可以在任务管理器结束对应进程Linux下用ps -ef | grep java找到进程kill掉再重启。5. 从交作业到答辩演示顺序与三个实用二次开发点源码跑通只是第一步真正能让这个项目在答辩现场站住脚的是演示顺序和几个锦上添花的改动。我建议演示时不要从登录页开始平铺直叙地讲而是先切入员工档案管理录一条在职员工、一条退休员工让评审看到新增和状态变化接着立刻演示缴费审核把刚才录入的员工所属单位做一笔应缴记录展示从待审核到已入账的过程。这样前后业务是连贯的比一个个菜单点过去有说服力得多。二次开发优先级最高的是补缴记录标志。源码里缴费状态的补缴和入账都通过字段区分但页面列表上最好增加一个颜色或标签来区分比如已补缴显示橙色标签。改动很小只要在JSP里判断pay_status的值不同值渲染不同class即可。第二个值得做的是导出Excel。答辩老师经常问能不能把缴费记录导出来用POI写一个简单的导出接口就够了。RequestMapping(/export) public void export(HttpServletRequest request, HttpServletResponse response) throws IOException { ListInsurancePay list payService.queryAll(); response.setContentType(application/vnd.ms-excel;charsetUTF-8); response.setHeader(Content-Disposition, attachment;filenamepay.xls); try (Workbook workbook new HSSFWorkbook()) { Sheet sheet workbook.createSheet(缴费记录); // 首行创建标题后续每行写入pay_period、total_amount、pay_state字段 for (int i 0; i list.size(); i) { Row row sheet.createRow(i 1); row.createCell(0).setCellValue(list.get(i).getPayPeriod()); row.createCell(1).setCellValue(list.get(i).getTotalAmount().doubleValue()); row.createCell(2).setCellValue(getPayStatusText(list.get(i).getPayStatus())); } workbook.write(response.getOutputStream()); } }这段代码把查询结果直接写入Excel响应流money字段转成double写入时注意精确度展示用途可以接受。如果改成小数点后两位需要设置单元格格式。第三个改动是把公告发布页的纯文本编辑器换成简单的富文本或者至少支持换行显示。源码里如果公告内容存的是长文本JSP页面默认会丢失换行可以用一个JSTL函数把换行符替换成br标签。演示验证清单我一般会提前走一遍管理员登录是否正常录入一条档案后列表能否立即刷新缴费审核后状态是否从待审核变成已入账退休员工能否成功领取退休金已故员工申请丧葬补助时能否正常通过以及一台没装过MySQL的机器能不能用自己的环境把这套流程完整复现。每一步都跑通心里才有底。这套系统我拆过不止一次最大的教训是拿到任何源码包都先跑通再动代码而不是一上来就想着改页面对接自己的创意功能。曾经为了改一个菜单名称直接改了数据库字段结果整套关联查询全部失效最后重新导库才救回来。从那以后我每次拿到这类项目都强制走一遍全流程导库、连接、启动、核心业务验证数据库脚本永远先备份再动刀。希望这套SSM社保系统的部署和改法能帮到你。本文还有配套的精品资源点击获取