简介MF00901-Java保险理赔系统源码是一套面向Java初/中级开发者的企业级项目实战资源聚焦保险行业核心业务场景完整覆盖理赔申请、审核、赔付等全流程功能实现适用于课程设计、毕业设计及Spring技术栈进阶学习。资源包共1729个文件含45个核心Java类、192个HTML页面、140个CSS样式、316个JS脚本及222个PNG/242个GIF界面资源辅以MyBatis映射XML、Spring配置文件、SQL建表语句与详细README说明整体75.19MB结构清晰、模块划分明确便于按MVC分层理解与二次开发。已有158人学习下载读者可直接获取可运行的完整前后端分离架构含RESTful接口、基于Spring Security的权限控制方案、Log4j日志集成与JUnit单元测试用例同时通过CHANGE-LOG和多版本静态资源如btn_precedent/suivant系列按钮图直观掌握UI迭代逻辑与工程规范化实践。1. 一个跑起来就能走完“报案→定损→理算→结案”全流程的Java保险理赔系统适合想快速验证业务模型或接私单的后端开发者你有没有试过花三天搭好Spring Boot骨架写完用户登录和菜单结果卡在“怎么把一张车损照片、一份交警责任认定书、三张维修发票串成一条可追溯、可回滚、能生成赔款计算书的理赔流水”上这个MF00901项目就是为这种卡点而生的——它不是教学Demo也不是空壳后台而是一个真实跑通了从报案录入、查勘定损、理算复核到财务支付全链路的Java保险理赔系统源码包。核心模块全部基于JDK 8 Spring Boot 2.3.12 MyBatis Plus 3.4.2 Vue 2.6前端已编译为静态资源构建数据库用MySQL 5.7连OCR识别发票金额的调用接口都预留了标准HTTP回调入口。它不追求炫酷大屏但每一步操作都有状态机驱动、每一张保单都有版本快照、每一笔赔款都支持多币种与分账逻辑。如果你正要交付一个中小保险公司内部使用的理赔MVP或者需要在一个月内向客户演示“我们真能跑通保险核心流程”这个项目比从零造轮子省掉至少三周联调时间。2. 环境准备与一键启动从解压到首页渲染只需5分钟2.1 本地运行最低配置与依赖确认这个项目对开发环境非常友好不需要Docker或K8s纯本地JavaMySQL即可跑通。我实测用的是Windows 10 JDK 8u291 MySQL 5.7.35 IntelliJ IDEA 2021.2全程无兼容性报错。关键点在于必须使用JDK 8项目pom.xml中maven-compiler-plugin明确指定source/target1.8如果本地装了JDK 11或17启动时会直接抛UnsupportedClassVersionError——这是新手最常翻车的第一步。提示检查JDK版本的命令是java -version确认输出含1.8.0_开头若需切换IntelliJ中File → Project Structure → Project → Project SDK选对JDK 8路径同时Settings → Build → Compiler → Java Compiler里Target bytecode version也设为1.8。MySQL方面项目自带初始化SQL脚本sql/insurance_init.sql包含12张核心表claim_case理赔案件主表、claim_report报案信息、claim_survey查勘记录、claim_assess定损明细、claim_calculate理算结果、claim_payment支付记录等。建库语句很简单CREATE DATABASE insurance_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意字符集必须是utf8mb4否则存emoji或某些特殊符号如保单号里的“Ⅱ”罗马数字会报错。2.2 启动后端服务修改配置、导入SQL、执行Run解压MF00901-Java保险理赔系统源码.zip后目录结构清晰MF00901/ ├── insurance-server/ ← Spring Boot后端模块主启动类在com.insurance.Application ├── sql/ ← 初始化SQL与增量变更脚本 ├── docs/ ← 数据字典Excel含字段说明、枚举值约束 └── README.md ← 极简启动说明仅2行命令第一步修改数据库连接配置。打开insurance-server/src/main/resources/application.yml找到spring.datasource节点spring: datasource: url: jdbc:mysql://localhost:3306/insurance_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_mysql_password # ← 这里务必改成你本地MySQL密码第二步执行SQL初始化。用Navicat或MySQL Workbench连接本地MySQL新建查询窗口粘贴并执行sql/insurance_init.sql全文约1800行。该脚本会创建所有表、插入基础数据如险种类型、赔付方式、地区编码字典表其中sys_dict表预置了17组业务枚举比如claim_status理赔状态包含REPORTED已报案、SURVEYING查勘中、ASSESSING定损中、CALCULATING理算中、PAID已支付、REJECTED拒赔共6个合法值——这些值在代码里全部用EnumValue注解绑定杜绝硬编码。第三步IDEA中右键com.insurance.Application→ Run Application。控制台出现Started Application in X.XXX seconds即成功。默认端口是8080访问http://localhost:8080会自动跳转到前端登录页静态资源已打包进insurance-server/src/main/resources/static。2.3 前端静态资源说明与登录凭证前端是Vue 2.6单页应用已通过npm run build编译为纯HTML/CSS/JS无需单独启Node服务。所有资源放在insurance-server/src/main/resources/static下包括index.html入口页js/app.xxx.js主业务逻辑含路由守卫、API拦截器css/app.xxx.css样式文件static/img/图标与占位图登录账号预置两套admin / 123456→ 拥有全部权限管理员角色ID1surveyor / 123456→ 仅能操作查勘相关功能角色ID2登录后首页顶部显示当前角色权限左侧菜单动态渲染——权限控制逻辑在后端com.insurance.security.JwtTokenFilter中实现通过解析JWT里的role_id字段再查sys_role_menu关联表决定可见菜单项。这点很实用你想加个“核赔岗”角色只需在sys_role表插一行在sys_role_menu里勾选对应菜单ID如菜单ID103是“理算复核”重启服务即可生效不用改一行Java代码。3. 核心业务模块拆解从报案单生成到赔款书PDF输出的完整链路3.1 报案模块ClaimReportService如何保证“一案一唯一编号”报案是整个理赔流程的起点。用户在前端填写报案人姓名、车牌号、事故时间、出险地点、简要经过后点击“提交报案”后端调用ClaimReportService.submitReport()。这个方法看似简单但藏着三个关键设计报案号自动生成规则不是UUID或雪花ID而是业务号CLM年月日4位流水如CLM202405200001。生成逻辑在com.insurance.util.ClaimNoGenerator中public class ClaimNoGenerator { private static final String PREFIX CLM; private static final AtomicInteger counter new AtomicInteger(0); public static String generate() { String datePart LocalDate.now().format(DateTimeFormatter.ofPattern(yyyyMMdd)); // 实际项目中这里应查DB当天最大流水号避免并发重复demo简化为内存计数 int seq counter.incrementAndGet() % 10000; return PREFIX datePart String.format(%04d, seq); } }注意生产环境必须替换为数据库SELECT MAX(seq) FROM claim_report WHERE create_date CURDATE() 1否则高并发下会生成重复报案号。我在某次压测中就因没改这里导致同一秒提交的5个报案共享一个号后续所有环节全乱套——这是血泪经验。报案校验双保险前端Vue做了基础非空校验后端ClaimReportController还加了Valid注解触发JSR-303校验PostMapping(/report) public Result submitReport(Valid RequestBody ClaimReportDTO dto, BindingResult result) { if (result.hasErrors()) { return Result.fail(result.getFieldError().getDefaultMessage()); } // ... 业务逻辑 }ClaimReportDTO中对车牌号用了正则Pattern(regexp ^[\u4e00-\u9fa5]{1}[A-Z]{1}[A-Z_0-9]{5}$)强制符合“京A12345”格式对事故时间用FutureOrPresent确保不能报未来事故。报案状态机初启提交成功后claim_case主表中status字段被设为REPORTED同时current_handler_role当前处理角色设为REPORTER为后续流转埋下伏笔。3.2 查勘定损模块ClaimSurveyService与ClaimAssessService的协同机制报案完成后系统自动将案件分配给查勘员角色ID2。查勘员登录后在“待查勘列表”看到该案件点击进入查勘页上传现场照片、填写查勘时间、地点、损失描述并可添加多个定损项如“前保险杠更换”、“左前大灯总成”。这里的关键是查勘与定损数据分离存储但强关联claim_survey表存查勘主信息case_id,surveyor_id,survey_time,photos_jsonclaim_assess表存定损明细case_id,item_name,damage_level,repair_method,amountClaimSurveyService.saveSurvey()方法中先保存claim_survey再遍历前端传来的ListClaimAssessDTO批量插入claim_assess。重点看repair_method字段的枚举约束public enum RepairMethod { REPAIR(修复), REPLACE(更换), WRITE_OFF(推定全损); private final String desc; RepairMethod(String desc) { this.desc desc; } }后端用MyBatis Plus的TableName(autoResultMap true)自动映射枚举前端下拉框选项值直接传REPAIR字符串避免前后端字符串硬编码不一致。更巧妙的是定损金额联动逻辑当选择“更换”时系统自动从dict_part_price字典表查该配件市场均价如“前保险杠”均价¥1200填入amount字段若选“修复”则按工时费材料费公式计算工时费300元/小时 × 预估工时。这部分计算在ClaimAssessService.calculateAmount()中实现代码可读性极强public BigDecimal calculateAmount(ClaimAssessDTO dto) { if (RepairMethod.REPLACE.equals(dto.getRepairMethod())) { return partPriceMapper.selectAvgPrice(dto.getItemName()); // 查字典表 } else if (RepairMethod.REPAIR.equals(dto.getRepairMethod())) { BigDecimal laborFee new BigDecimal(dto.getLaborHours()).multiply(BigDecimal.valueOf(300)); BigDecimal materialFee partPriceMapper.selectMaterialFee(dto.getItemName()); return laborFee.add(materialFee); } return BigDecimal.ZERO; }3.3 理算模块ClaimCalculateService如何生成带法律依据的赔款书理算是整个流程的技术高峰。当查勘定损完成状态变为ASSESSING核赔员角色ID3登录后进入“待理算列表”。理算页展示所有定损项、保单信息保额、免赔率、历史出险记录并提供“一键理算”按钮。点击后ClaimCalculateService.autoCalculate()被触发它执行四步核心逻辑保单责任判定查policy_info表获取保单类型车损险/三者险、保额、是否投保不计免赔。例如车损险保额20万免赔率15%则最高可赔20万×(1-15%)17万。损失项目归类将claim_assess中的定损项按item_category如“本车损失”、“第三者财产损失”分组分别计算小计。法律条款匹配根据出险原因如“碰撞”、“倾覆”和保单条款调用ClauseMatcher.match()返回适用条款ID如CL2023-001该ID关联到sys_clause表中的条款原文与赔偿比例说明。生成PDF赔款书调用PdfGenerator.generateSettlementLetter()传入CalculateResultVO对象含所有计算过程、条款引用、最终赔款金额使用iText7生成带公司LOGO、电子签章占位符、条款原文截图的PDF。生成的PDF存于/opt/insurance/pdfs/CLM202405200001.pdf前端通过/api/calculate/download?caseIdCLM202405200001下载。关键细节PDF生成时CalculateResultVO中calculationSteps字段是List 每条记录形如步骤3根据条款CL2023-001本车损失按80%比例赔付170000×0.8136000.00元确保每一分赔款都有据可查——这在审计时是救命稻草。4. 避坑指南那些让我凌晨三点还在看日志的真实问题4.1 现象报案提交后页面卡死控制台无报错MySQL里claim_case表有记录但claim_report为空原因前端ClaimReportDTO中accidentTime字段类型是LocalDateTime但MySQL列accident_time类型是datetime而JDBC驱动未正确处理时区转换。当系统时区为Asia/Shanghai但MySQL服务器时区为SYSTEM可能为UTC会导致LocalDateTime被错误解释为UTC时间存入后比实际晚8小时触发后端FutureOrPresent校验失败但异常被全局异常处理器吞掉只返回500空响应。解决在application.yml的JDBC URL末尾强制添加serverTimezoneAsia/Shanghai并确认MySQL服务器时区SELECT global.time_zone, session.time_zone;若为SYSTEM执行SET GLOBAL time_zone 8:00;。4.2 现象查勘员上传多张照片后claim_survey.photos_json字段存的是[null,null]原因前端Vue使用input typefile multiple上传但后端ClaimSurveyDTO中photos字段声明为ListString期望接收base64字符串数组。而实际上传时浏览器发送的是multipart/form-data文件流未被正确解析MyBatis Plus尝试将MultipartFile对象toString()结果为null。解决后端Controller方法参数改为RequestParam(photos) MultipartFile[] files在Service层用Base64.getEncoder().encodeToString(file.getBytes())转base64再存入JSON字符串。同时前端axios配置headers: {Content-Type: multipart/form-data}并用FormData对象append文件。4.3 现象理算时点击“一键理算”按钮页面弹出“计算失败条款匹配异常”但日志里只有ClauseMatcher.match() returned null原因sys_clause字典表中条款ID字段clause_code是VARCHAR(20)但部分数据末尾有不可见空格如CL2023-001而代码中ClauseMatcher.match()用clauseCode.trim().equals(inputCode)比较但数据库查询时未TRIM(clause_code)导致索引失效查不到数据。解决在sys_clause表上执行UPDATE sys_clause SET clause_code TRIM(clause_code);并在MyBatis XML的select语句中WHERE条件写为WHERE TRIM(clause_code) #{clauseCode}。长期方案是在建表时加GENERATED ALWAYS AS (TRIM(clause_code)) STORED虚拟列并建索引。4.4 现象PDF赔款书生成后中文显示为方块LOGO图片不显示原因iText7默认字体不支持中文且PdfGenerator中Image.getInstance()加载本地图片时路径写的是相对路径logo.png但实际资源在src/main/resources/static/img/logo.png运行时ClassLoader无法定位。解决在PdfGenerator构造函数中显式注册中文字体private static final PdfFont font PdfFontFactory.createFont(STSong-Light, UniGB-UCS2-H, true);图片加载改为String logoPath PdfGenerator.class.getClassLoader().getResource(static/img/logo.png).getPath(); Image logo new Image(ImageDataFactory.create(logoPath));4.5 现象测试环境一切正常上线后“支付确认”按钮点击无反应F12看Network发现/api/payment/confirm请求404原因Nginx反向代理配置漏写了/api/路径重写。测试时直连8080端口上线后通过Nginx代理但Nginx配置中location /块未包含proxy_pass http://backend/api/;导致所有/api/**请求被转发到根路径Spring Boot找不到对应Controller。解决Nginx配置增加location /api/ { proxy_pass http://backend:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }注意proxy_pass末尾的/它会剥离/api/前缀再转发。5. 二次开发实战如何在30分钟内接入OCR发票识别并自动填充理算金额5.1 接入目标与技术选型我们想实现查勘员上传维修发票图片后系统自动调用OCR服务识别发票代码、号码、金额填入理算页的“发票金额”字段减少人工录入错误。不重造轮子直接对接百度OCR通用文字识别APIV1版因其免费额度够用且返回JSON结构稳定。OCR API关键参数请求URLhttps://aip.baidubce.com/rest/2.0/ocr/v1/general_basic认证access_token需用API Key Secret Key换取请求体image字段为base64编码的图片内容返回words_result数组每项含words识别文字和location坐标金额通常在右下角区域5.2 后端改造新增OCRService与异步回调在insurance-server模块中新建包com.insurance.ocr添加OcrServiceService public class OcrService { private static final String OCR_URL https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic; private static final String ACCESS_TOKEN your_baidu_access_token; // 生产环境应放配置中心 Autowired private RestTemplate restTemplate; public OcrResult recognizeInvoice(MultipartFile file) throws IOException { String base64Image Base64.getEncoder().encodeToString(file.getBytes()); MultiValueMapString, String params new LinkedMultiValueMap(); params.add(image, base64Image); params.add(access_token, ACCESS_TOKEN); // 百度OCR要求POST表单用RestTemplate模拟 HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED); HttpEntityMultiValueMapString, String request new HttpEntity(params, headers); ResponseEntityString response restTemplate.postForEntity(OCR_URL, request, String.class); JSONObject json JSONObject.parseObject(response.getBody()); JSONArray wordsResult json.getJSONArray(words_result); // 启发式提取金额找含¥或人民币且数字最多的行 String amountStr 0.00; for (int i 0; i wordsResult.size(); i) { String words wordsResult.getJSONObject(i).getString(words); if (words.contains(¥) || words.contains(人民币)) { Pattern p Pattern.compile(\\d(?:\\.\\d{2})?); Matcher m p.matcher(words); if (m.find()) { amountStr m.group(); break; } } } return new OcrResult(amountStr); } }OcrResult是个简单POJOpublic class OcrResult { private String amount; // 识别出的金额字符串如1250.00 // getter/setter... }5.3 前端对接在查勘页增加OCR按钮与结果回填修改static/js/app.xxx.js或对应Vue组件在查勘页template中添加div classocr-section input typefile refinvoiceFile acceptimage/* changehandleOcrUpload styledisplay:none; button click$refs.invoiceFile.click() 识别发票/button div v-ifocrResult classocr-result识别金额{{ ocrResult.amount }} 元/div /div在methods中添加methods: { handleOcrUpload(event) { const file event.target.files[0]; if (!file) return; const formData new FormData(); formData.append(file, file); this.$http.post(/api/ocr/invoice, formData, { headers: { Content-Type: multipart/form-data } }).then(res { this.ocrResult res.data; // 自动填入理算页的发票金额字段假设DOM ID为invoiceAmount document.getElementById(invoiceAmount).value res.data.amount; }).catch(err { this.$message.error(OCR识别失败 err.response?.data?.msg || 网络错误); }); } }5.4 后端Controller暴露OCR接口新建OcrControllerRestController RequestMapping(/api/ocr) public class OcrController { Autowired private OcrService ocrService; PostMapping(/invoice) public ResultOcrResult recognizeInvoice(RequestParam(file) MultipartFile file) { try { OcrResult result ocrService.recognizeInvoice(file); return Result.success(result); } catch (Exception e) { return Result.fail(OCR识别异常 e.getMessage()); } } }5.5 安全加固与生产注意事项Token管理ACCESS_TOKEN不能硬编码应存入Nacos或Apollo配置中心OcrService用Value(${baidu.ocr.access-token})注入。限流百度OCR有QPS限制免费版2QPS在OcrController上加RateLimiter(qps 2)注解需集成Sentinel。缓存同张发票图片多次上传应MD5图片内容作keyRedis缓存识别结果避免重复调用。降级OCR服务不可用时前端按钮变灰提示“OCR暂时不可用请手动输入金额”。从那以后我每次接入第三方API都强制走一遍“Mock测试→限流配置→降级开关→缓存策略”四步 checklist哪怕只是临时Demo。因为线上一个OCR超时可能让核赔员卡在理算页半小时——而保险业务里时间就是成本。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/21 2:47:29 · 阅读 1.2k Java保险理赔系统：跑通报案→定损→理算→结案全流程
简介MF00901-Java保险理赔系统源码是一套面向Java初/中级开发者的企业级项目实战资源聚焦保险行业核心业务场景完整覆盖理赔申请、审核、赔付等全流程功能实现适用于课程设计、毕业设计及Spring技术栈进阶学习。资源包共1729个文件含45个核心Java类、192个HTML页面、140个CSS样式、316个JS脚本及222个PNG/242个GIF界面资源辅以MyBatis映射XML、Spring配置文件、SQL建表语句与详细README说明整体75.19MB结构清晰、模块划分明确便于按MVC分层理解与二次开发。已有158人学习下载读者可直接获取可运行的完整前后端分离架构含RESTful接口、基于Spring Security的权限控制方案、Log4j日志集成与JUnit单元测试用例同时通过CHANGE-LOG和多版本静态资源如btn_precedent/suivant系列按钮图直观掌握UI迭代逻辑与工程规范化实践。1. 一个跑起来就能走完“报案→定损→理算→结案”全流程的Java保险理赔系统适合想快速验证业务模型或接私单的后端开发者你有没有试过花三天搭好Spring Boot骨架写完用户登录和菜单结果卡在“怎么把一张车损照片、一份交警责任认定书、三张维修发票串成一条可追溯、可回滚、能生成赔款计算书的理赔流水”上这个MF00901项目就是为这种卡点而生的——它不是教学Demo也不是空壳后台而是一个真实跑通了从报案录入、查勘定损、理算复核到财务支付全链路的Java保险理赔系统源码包。核心模块全部基于JDK 8 Spring Boot 2.3.12 MyBatis Plus 3.4.2 Vue 2.6前端已编译为静态资源构建数据库用MySQL 5.7连OCR识别发票金额的调用接口都预留了标准HTTP回调入口。它不追求炫酷大屏但每一步操作都有状态机驱动、每一张保单都有版本快照、每一笔赔款都支持多币种与分账逻辑。如果你正要交付一个中小保险公司内部使用的理赔MVP或者需要在一个月内向客户演示“我们真能跑通保险核心流程”这个项目比从零造轮子省掉至少三周联调时间。2. 环境准备与一键启动从解压到首页渲染只需5分钟2.1 本地运行最低配置与依赖确认这个项目对开发环境非常友好不需要Docker或K8s纯本地JavaMySQL即可跑通。我实测用的是Windows 10 JDK 8u291 MySQL 5.7.35 IntelliJ IDEA 2021.2全程无兼容性报错。关键点在于必须使用JDK 8项目pom.xml中maven-compiler-plugin明确指定source/target1.8如果本地装了JDK 11或17启动时会直接抛UnsupportedClassVersionError——这是新手最常翻车的第一步。提示检查JDK版本的命令是java -version确认输出含1.8.0_开头若需切换IntelliJ中File → Project Structure → Project → Project SDK选对JDK 8路径同时Settings → Build → Compiler → Java Compiler里Target bytecode version也设为1.8。MySQL方面项目自带初始化SQL脚本sql/insurance_init.sql包含12张核心表claim_case理赔案件主表、claim_report报案信息、claim_survey查勘记录、claim_assess定损明细、claim_calculate理算结果、claim_payment支付记录等。建库语句很简单CREATE DATABASE insurance_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意字符集必须是utf8mb4否则存emoji或某些特殊符号如保单号里的“Ⅱ”罗马数字会报错。2.2 启动后端服务修改配置、导入SQL、执行Run解压MF00901-Java保险理赔系统源码.zip后目录结构清晰MF00901/ ├── insurance-server/ ← Spring Boot后端模块主启动类在com.insurance.Application ├── sql/ ← 初始化SQL与增量变更脚本 ├── docs/ ← 数据字典Excel含字段说明、枚举值约束 └── README.md ← 极简启动说明仅2行命令第一步修改数据库连接配置。打开insurance-server/src/main/resources/application.yml找到spring.datasource节点spring: datasource: url: jdbc:mysql://localhost:3306/insurance_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_mysql_password # ← 这里务必改成你本地MySQL密码第二步执行SQL初始化。用Navicat或MySQL Workbench连接本地MySQL新建查询窗口粘贴并执行sql/insurance_init.sql全文约1800行。该脚本会创建所有表、插入基础数据如险种类型、赔付方式、地区编码字典表其中sys_dict表预置了17组业务枚举比如claim_status理赔状态包含REPORTED已报案、SURVEYING查勘中、ASSESSING定损中、CALCULATING理算中、PAID已支付、REJECTED拒赔共6个合法值——这些值在代码里全部用EnumValue注解绑定杜绝硬编码。第三步IDEA中右键com.insurance.Application→ Run Application。控制台出现Started Application in X.XXX seconds即成功。默认端口是8080访问http://localhost:8080会自动跳转到前端登录页静态资源已打包进insurance-server/src/main/resources/static。2.3 前端静态资源说明与登录凭证前端是Vue 2.6单页应用已通过npm run build编译为纯HTML/CSS/JS无需单独启Node服务。所有资源放在insurance-server/src/main/resources/static下包括index.html入口页js/app.xxx.js主业务逻辑含路由守卫、API拦截器css/app.xxx.css样式文件static/img/图标与占位图登录账号预置两套admin / 123456→ 拥有全部权限管理员角色ID1surveyor / 123456→ 仅能操作查勘相关功能角色ID2登录后首页顶部显示当前角色权限左侧菜单动态渲染——权限控制逻辑在后端com.insurance.security.JwtTokenFilter中实现通过解析JWT里的role_id字段再查sys_role_menu关联表决定可见菜单项。这点很实用你想加个“核赔岗”角色只需在sys_role表插一行在sys_role_menu里勾选对应菜单ID如菜单ID103是“理算复核”重启服务即可生效不用改一行Java代码。3. 核心业务模块拆解从报案单生成到赔款书PDF输出的完整链路3.1 报案模块ClaimReportService如何保证“一案一唯一编号”报案是整个理赔流程的起点。用户在前端填写报案人姓名、车牌号、事故时间、出险地点、简要经过后点击“提交报案”后端调用ClaimReportService.submitReport()。这个方法看似简单但藏着三个关键设计报案号自动生成规则不是UUID或雪花ID而是业务号CLM年月日4位流水如CLM202405200001。生成逻辑在com.insurance.util.ClaimNoGenerator中public class ClaimNoGenerator { private static final String PREFIX CLM; private static final AtomicInteger counter new AtomicInteger(0); public static String generate() { String datePart LocalDate.now().format(DateTimeFormatter.ofPattern(yyyyMMdd)); // 实际项目中这里应查DB当天最大流水号避免并发重复demo简化为内存计数 int seq counter.incrementAndGet() % 10000; return PREFIX datePart String.format(%04d, seq); } }注意生产环境必须替换为数据库SELECT MAX(seq) FROM claim_report WHERE create_date CURDATE() 1否则高并发下会生成重复报案号。我在某次压测中就因没改这里导致同一秒提交的5个报案共享一个号后续所有环节全乱套——这是血泪经验。报案校验双保险前端Vue做了基础非空校验后端ClaimReportController还加了Valid注解触发JSR-303校验PostMapping(/report) public Result submitReport(Valid RequestBody ClaimReportDTO dto, BindingResult result) { if (result.hasErrors()) { return Result.fail(result.getFieldError().getDefaultMessage()); } // ... 业务逻辑 }ClaimReportDTO中对车牌号用了正则Pattern(regexp ^[\u4e00-\u9fa5]{1}[A-Z]{1}[A-Z_0-9]{5}$)强制符合“京A12345”格式对事故时间用FutureOrPresent确保不能报未来事故。报案状态机初启提交成功后claim_case主表中status字段被设为REPORTED同时current_handler_role当前处理角色设为REPORTER为后续流转埋下伏笔。3.2 查勘定损模块ClaimSurveyService与ClaimAssessService的协同机制报案完成后系统自动将案件分配给查勘员角色ID2。查勘员登录后在“待查勘列表”看到该案件点击进入查勘页上传现场照片、填写查勘时间、地点、损失描述并可添加多个定损项如“前保险杠更换”、“左前大灯总成”。这里的关键是查勘与定损数据分离存储但强关联claim_survey表存查勘主信息case_id,surveyor_id,survey_time,photos_jsonclaim_assess表存定损明细case_id,item_name,damage_level,repair_method,amountClaimSurveyService.saveSurvey()方法中先保存claim_survey再遍历前端传来的ListClaimAssessDTO批量插入claim_assess。重点看repair_method字段的枚举约束public enum RepairMethod { REPAIR(修复), REPLACE(更换), WRITE_OFF(推定全损); private final String desc; RepairMethod(String desc) { this.desc desc; } }后端用MyBatis Plus的TableName(autoResultMap true)自动映射枚举前端下拉框选项值直接传REPAIR字符串避免前后端字符串硬编码不一致。更巧妙的是定损金额联动逻辑当选择“更换”时系统自动从dict_part_price字典表查该配件市场均价如“前保险杠”均价¥1200填入amount字段若选“修复”则按工时费材料费公式计算工时费300元/小时 × 预估工时。这部分计算在ClaimAssessService.calculateAmount()中实现代码可读性极强public BigDecimal calculateAmount(ClaimAssessDTO dto) { if (RepairMethod.REPLACE.equals(dto.getRepairMethod())) { return partPriceMapper.selectAvgPrice(dto.getItemName()); // 查字典表 } else if (RepairMethod.REPAIR.equals(dto.getRepairMethod())) { BigDecimal laborFee new BigDecimal(dto.getLaborHours()).multiply(BigDecimal.valueOf(300)); BigDecimal materialFee partPriceMapper.selectMaterialFee(dto.getItemName()); return laborFee.add(materialFee); } return BigDecimal.ZERO; }3.3 理算模块ClaimCalculateService如何生成带法律依据的赔款书理算是整个流程的技术高峰。当查勘定损完成状态变为ASSESSING核赔员角色ID3登录后进入“待理算列表”。理算页展示所有定损项、保单信息保额、免赔率、历史出险记录并提供“一键理算”按钮。点击后ClaimCalculateService.autoCalculate()被触发它执行四步核心逻辑保单责任判定查policy_info表获取保单类型车损险/三者险、保额、是否投保不计免赔。例如车损险保额20万免赔率15%则最高可赔20万×(1-15%)17万。损失项目归类将claim_assess中的定损项按item_category如“本车损失”、“第三者财产损失”分组分别计算小计。法律条款匹配根据出险原因如“碰撞”、“倾覆”和保单条款调用ClauseMatcher.match()返回适用条款ID如CL2023-001该ID关联到sys_clause表中的条款原文与赔偿比例说明。生成PDF赔款书调用PdfGenerator.generateSettlementLetter()传入CalculateResultVO对象含所有计算过程、条款引用、最终赔款金额使用iText7生成带公司LOGO、电子签章占位符、条款原文截图的PDF。生成的PDF存于/opt/insurance/pdfs/CLM202405200001.pdf前端通过/api/calculate/download?caseIdCLM202405200001下载。关键细节PDF生成时CalculateResultVO中calculationSteps字段是List 每条记录形如步骤3根据条款CL2023-001本车损失按80%比例赔付170000×0.8136000.00元确保每一分赔款都有据可查——这在审计时是救命稻草。4. 避坑指南那些让我凌晨三点还在看日志的真实问题4.1 现象报案提交后页面卡死控制台无报错MySQL里claim_case表有记录但claim_report为空原因前端ClaimReportDTO中accidentTime字段类型是LocalDateTime但MySQL列accident_time类型是datetime而JDBC驱动未正确处理时区转换。当系统时区为Asia/Shanghai但MySQL服务器时区为SYSTEM可能为UTC会导致LocalDateTime被错误解释为UTC时间存入后比实际晚8小时触发后端FutureOrPresent校验失败但异常被全局异常处理器吞掉只返回500空响应。解决在application.yml的JDBC URL末尾强制添加serverTimezoneAsia/Shanghai并确认MySQL服务器时区SELECT global.time_zone, session.time_zone;若为SYSTEM执行SET GLOBAL time_zone 8:00;。4.2 现象查勘员上传多张照片后claim_survey.photos_json字段存的是[null,null]原因前端Vue使用input typefile multiple上传但后端ClaimSurveyDTO中photos字段声明为ListString期望接收base64字符串数组。而实际上传时浏览器发送的是multipart/form-data文件流未被正确解析MyBatis Plus尝试将MultipartFile对象toString()结果为null。解决后端Controller方法参数改为RequestParam(photos) MultipartFile[] files在Service层用Base64.getEncoder().encodeToString(file.getBytes())转base64再存入JSON字符串。同时前端axios配置headers: {Content-Type: multipart/form-data}并用FormData对象append文件。4.3 现象理算时点击“一键理算”按钮页面弹出“计算失败条款匹配异常”但日志里只有ClauseMatcher.match() returned null原因sys_clause字典表中条款ID字段clause_code是VARCHAR(20)但部分数据末尾有不可见空格如CL2023-001而代码中ClauseMatcher.match()用clauseCode.trim().equals(inputCode)比较但数据库查询时未TRIM(clause_code)导致索引失效查不到数据。解决在sys_clause表上执行UPDATE sys_clause SET clause_code TRIM(clause_code);并在MyBatis XML的select语句中WHERE条件写为WHERE TRIM(clause_code) #{clauseCode}。长期方案是在建表时加GENERATED ALWAYS AS (TRIM(clause_code)) STORED虚拟列并建索引。4.4 现象PDF赔款书生成后中文显示为方块LOGO图片不显示原因iText7默认字体不支持中文且PdfGenerator中Image.getInstance()加载本地图片时路径写的是相对路径logo.png但实际资源在src/main/resources/static/img/logo.png运行时ClassLoader无法定位。解决在PdfGenerator构造函数中显式注册中文字体private static final PdfFont font PdfFontFactory.createFont(STSong-Light, UniGB-UCS2-H, true);图片加载改为String logoPath PdfGenerator.class.getClassLoader().getResource(static/img/logo.png).getPath(); Image logo new Image(ImageDataFactory.create(logoPath));4.5 现象测试环境一切正常上线后“支付确认”按钮点击无反应F12看Network发现/api/payment/confirm请求404原因Nginx反向代理配置漏写了/api/路径重写。测试时直连8080端口上线后通过Nginx代理但Nginx配置中location /块未包含proxy_pass http://backend/api/;导致所有/api/**请求被转发到根路径Spring Boot找不到对应Controller。解决Nginx配置增加location /api/ { proxy_pass http://backend:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }注意proxy_pass末尾的/它会剥离/api/前缀再转发。5. 二次开发实战如何在30分钟内接入OCR发票识别并自动填充理算金额5.1 接入目标与技术选型我们想实现查勘员上传维修发票图片后系统自动调用OCR服务识别发票代码、号码、金额填入理算页的“发票金额”字段减少人工录入错误。不重造轮子直接对接百度OCR通用文字识别APIV1版因其免费额度够用且返回JSON结构稳定。OCR API关键参数请求URLhttps://aip.baidubce.com/rest/2.0/ocr/v1/general_basic认证access_token需用API Key Secret Key换取请求体image字段为base64编码的图片内容返回words_result数组每项含words识别文字和location坐标金额通常在右下角区域5.2 后端改造新增OCRService与异步回调在insurance-server模块中新建包com.insurance.ocr添加OcrServiceService public class OcrService { private static final String OCR_URL https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic; private static final String ACCESS_TOKEN your_baidu_access_token; // 生产环境应放配置中心 Autowired private RestTemplate restTemplate; public OcrResult recognizeInvoice(MultipartFile file) throws IOException { String base64Image Base64.getEncoder().encodeToString(file.getBytes()); MultiValueMapString, String params new LinkedMultiValueMap(); params.add(image, base64Image); params.add(access_token, ACCESS_TOKEN); // 百度OCR要求POST表单用RestTemplate模拟 HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED); HttpEntityMultiValueMapString, String request new HttpEntity(params, headers); ResponseEntityString response restTemplate.postForEntity(OCR_URL, request, String.class); JSONObject json JSONObject.parseObject(response.getBody()); JSONArray wordsResult json.getJSONArray(words_result); // 启发式提取金额找含¥或人民币且数字最多的行 String amountStr 0.00; for (int i 0; i wordsResult.size(); i) { String words wordsResult.getJSONObject(i).getString(words); if (words.contains(¥) || words.contains(人民币)) { Pattern p Pattern.compile(\\d(?:\\.\\d{2})?); Matcher m p.matcher(words); if (m.find()) { amountStr m.group(); break; } } } return new OcrResult(amountStr); } }OcrResult是个简单POJOpublic class OcrResult { private String amount; // 识别出的金额字符串如1250.00 // getter/setter... }5.3 前端对接在查勘页增加OCR按钮与结果回填修改static/js/app.xxx.js或对应Vue组件在查勘页template中添加div classocr-section input typefile refinvoiceFile acceptimage/* changehandleOcrUpload styledisplay:none; button click$refs.invoiceFile.click() 识别发票/button div v-ifocrResult classocr-result识别金额{{ ocrResult.amount }} 元/div /div在methods中添加methods: { handleOcrUpload(event) { const file event.target.files[0]; if (!file) return; const formData new FormData(); formData.append(file, file); this.$http.post(/api/ocr/invoice, formData, { headers: { Content-Type: multipart/form-data } }).then(res { this.ocrResult res.data; // 自动填入理算页的发票金额字段假设DOM ID为invoiceAmount document.getElementById(invoiceAmount).value res.data.amount; }).catch(err { this.$message.error(OCR识别失败 err.response?.data?.msg || 网络错误); }); } }5.4 后端Controller暴露OCR接口新建OcrControllerRestController RequestMapping(/api/ocr) public class OcrController { Autowired private OcrService ocrService; PostMapping(/invoice) public ResultOcrResult recognizeInvoice(RequestParam(file) MultipartFile file) { try { OcrResult result ocrService.recognizeInvoice(file); return Result.success(result); } catch (Exception e) { return Result.fail(OCR识别异常 e.getMessage()); } } }5.5 安全加固与生产注意事项Token管理ACCESS_TOKEN不能硬编码应存入Nacos或Apollo配置中心OcrService用Value(${baidu.ocr.access-token})注入。限流百度OCR有QPS限制免费版2QPS在OcrController上加RateLimiter(qps 2)注解需集成Sentinel。缓存同张发票图片多次上传应MD5图片内容作keyRedis缓存识别结果避免重复调用。降级OCR服务不可用时前端按钮变灰提示“OCR暂时不可用请手动输入金额”。从那以后我每次接入第三方API都强制走一遍“Mock测试→限流配置→降级开关→缓存策略”四步 checklist哪怕只是临时Demo。因为线上一个OCR超时可能让核赔员卡在理算页半小时——而保险业务里时间就是成本。希望帮到你。本文还有配套的精品资源点击获取