生产大文件下载导致 OOM,顺藤摸瓜拿下

一次线上OOM的深度复盘:从VisualVM线程堆栈到问题代码行 本文深度复盘了一次线上OOM(内存溢出)的排查全过程。通过保留现场生成dump文件,利用VisualVM分析线程堆栈与对象实例,最终精准定位到问题代码行——因查询条件全部被跳过导致的全表扫描。文章分享了从取证、分析到修复的完整实战经验,并总结了构建OOM排查体系的核心流程与防御策略。 阅读详情

👉 这是一个或许对你有用的社群

🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料: 

bc8cfea5ba525244dd7d45dc4546cac0.gif

👉这是一个或许对你有用的开源项目

国产 Star 破 10w+ 的开源项目,前端包括管理后台 + 微信小程序,后端支持单体和微服务架构。

功能涵盖 RBAC 权限、SaaS 多租户、数据权限、商城、支付、工作流、大屏报表、微信公众号、CRM 等等功能:

  • Boot 仓库:https://gitee.com/zhijiantianya/ruoyi-vue-pro

  • Cloud 仓库:https://gitee.com/zhijiantianya/yudao-cloud

  • 视频教程:https://doc.iocoder.cn

【国内首批】支持 JDK 21 + SpringBoot 3.2.2、JDK 8 + Spring Boot 2.7.18 双版本 

来源:飞天小牛肉


1 简介

Graceful Response是一个Spring Boot技术栈下的优雅响应处理器,提供一站式统一返回值封装、全局异常处理、自定义异常错误码 等功能,使用Graceful Response进行web接口开发不仅可以节省大量的时间,还可以提高代码质量,使代码逻辑更清晰。

强烈推荐你花3分钟学会它!

本项目案例工程代码:https://github.com/feiniaojin/graceful-response-example.git ,注意选择最新版本的分支。

Spring Boot版本Graceful Response版本graceful-response-example分支
2.x3.2.1-boot23.2.0-boot2
3.x3.2.1-boot33.2.0-boot3

注意,3.2.1-boot2版本的Graceful Response源码由单独的仓库进行维护,地址为:https://github.com/feiniaojin/graceful-response-boot2

3.2.1-boot2和3.2.1-boot3除了支持的SpringBoot版本不一样,其他实现完全一致,Maven引用时只需要根据对应的SpringBoot版本选择Graceful Response的version即可,两者的groupId、artifactId是一致的。

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

  • 项目地址:https://github.com/YunaiV/ruoyi-vue-pro

  • 视频教程:https://doc.iocoder.cn/video/

2 快速入门

2.1 Spring Boot接口开发现状

目前,业界使用Spring Boot进行接口开发时,往往存在效率底下、重复劳动、可读性差等问题。以下伪代码相信大家非常熟悉,我们大部分项目的Controller接口都是这样的。

@Controller
public class Controller {

  @GetMapping("/query")
  @ResponseBody
  public Response query(Map<String, Object> paramMap) {
    Response res = new Response();
    try {
      //1.校验params参数合法性,包括非空校验、长度校验等
      if (illegal(paramMap)) {
        res.setCode(1);
        res.setMsg("error");
        return res;
      }
      //2.调用Service的一系列操作,得到查询结果
      Object data = service.query(params);
      //3.将操作结果设置到res对象中
      res.setData(data);
      res.setCode(0);
      res.setMsg("ok");
      return res;
    } catch (Exception e) {
      //4.异常处理:一堆丑陋的try...catch,如果有错误码的,还需要手工填充错误码
      res.setCode(1);
      res.setMsg("error");
      return res;
    }
  }
}

这段伪代码存在什么样的问题呢?

第一个问题,效率低下。 Controller层的代码应该尽量简洁,上面的伪代码其实只是为了将数据查询的结果进行封装,使其以统一的格式进行返回。例如以下格式的响应体:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 1,
    "name": "username"
  }
}

查询过程中如果发生异常,需要在Controller进行手工捕获,根据捕获的异常人工地设置错误码,当然,也用同样的格式封装错误码进行返回。

可以看到,除了调用service层的query方法这一行,其他大部分的代码都执行进行结果的封装,大量的冗余、低价值的代码导致我们的开发活动效率很低。

第二个问题,重复劳动。 以上捕获异常、封装执行结果的操作,每个接口都会进行一次,因此造成大量重复劳动。

第三个问题,可读性低。 上面的核心代码被淹没在许多冗余代码中,很难阅读,如同大海捞针。

我们可以通过Graceful Response这个组件解决这样的问题。

2.2. 快速入门

2.2.1 引入Graceful Response组件

Graceful Response已发布至maven中央仓库,我们可以直接引入到项目中。

maven依赖如下:

<dependency>
  <groupId>com.feiniaojin</groupId>
  <artifactId>graceful-response</artifactId>
  <version>{latest.version}</version>
</dependency>
Spring Boot版本Graceful Response最新版本
2.x3.2.1-boot2
3.x3.2.1-boot3
2.2.2 启用Graceful Response

在启动类中引入@EnableGracefulResponse注解,即可启用Graceful Response组件。

@EnableGracefulResponse
@SpringBootApplication
public class ExampleApplication {
  public static void main(String[] args) {
    SpringApplication.run(ExampleApplication.class, args);
  }
}
2.2.3 Controller层

引入Graceful Response后,我们不需要再手工进行查询结果的封装,直接返回实际结果即可,Graceful Response会自动完成封装的操作。

Controller层示例如下。

@Controller
public class Controller {
  @RequestMapping("/get")
  @ResponseBody
  public UserInfoView get(Long id) {
    log.info("id={}", id);
    return UserInfoView.builder().id(id).name("name" + id).build();
  }
}

在示例代码中,Controller层的方法直接返回了UserInfoView对象,没有进行封装的操作,但经过Graceful Response处理后,我们还是得到了以下的响应结果。

{
  "status": {
    "code": "0",
    "msg": "ok"
  },
  "payload": {
    "id": 1,
    "name": "name1"
  }
}

而对于命令操作(Command)尽量不返回数据,因此command操作的方法的返回值应该是void,Graceful Response对于对于返回值类型void的方法,也会自动进行封装。

public class Controller {
  @RequestMapping("/command")
  @ResponseBody
  public void command() {
    //业务操作
  }
}

成功调用该接口,将得到:

{
  "status": {
    "code": "200",
    "msg": "success"
  },
  "payload": {}
}
2.2.4 Service层

在引入Graceful Response前,有的开发者在定义Service层的方法时,为了在接口中返回异常码,干脆直接将Service层方法定义为Response,淹没了方法的正常返回值。

Response的代码如下。

//lombok注解
@Data
public class Response {
  private String code;
  private String msg;
  private Object data;
}

直接返回Response的Service层方法:

/**
 * 直接返回Reponse的Service
 * 不规范
 */
public interface Service {
  public Reponse commandMethod(Command command);
}

Graceful Response引入@ExceptionMapper注解,通过该注解将异常和错误码关联起来,这样Service方法就不需要再维护Response的响应码了,直接抛出业务异常,由Graceful Response进行异常和响应码的关联。

@ExceptionMapper的用法如下。

/**
 * NotFoundException的定义,使用@ExceptionMapper注解修饰
 * code:代表接口的异常码
 * msg:代表接口的异常提示
 */
@ExceptionMapper(code = "1404", msg = "找不到对象")
public class NotFoundException extends RuntimeException {

}

Service接口定义:

public interface QueryService {
  UserInfoView queryOne(Query query);
}

Service接口实现:

public class QueryServiceImpl implements QueryService {
  @Resource
  private UserInfoMapper mapper;

  public UserInfoView queryOne(Query query) {
    UserInfo userInfo = mapper.findOne(query.getId());
    if (Objects.isNull(userInfo)) {
      //这里直接抛自定义异常
      throw new NotFoundException();
    }
    //……后续业务操作
  }
}

当Service层的queryOne方法抛出NotFoundException时,Graceful Response会进行异常捕获,并将NotFoundException对应的异常码和异常信息封装到统一的响应对象中,最终接口返回以下JSON。

{
        "status": {
        "code": "1404",
        "msg": "找不到对象"
        },
        "payload": {}
        }
2.2.5 参数校验

Graceful Response对JSR-303数据校验规范和Hibernate Validator进行了增强,Graceful Response自身不提供参数校验的功能,但是用户使用了Hibernate Validator后,Graceful Response可以通过@ValidationStatusCode注解为参数校验结果提供响应码,并将其统一封装返回。

例如以下的UserInfoQuery。

@Data
public class UserInfoQuery {
  @NotNull(message = "userName is null !")
  @Length(min = 6, max = 12)
  @ValidationStatusCode(code = "520")
  private String userName;
}

UserInfoQuery对象中定义了@NotNull和@Length两个校验规则,在未引入Graceful Response的情况下,会直接抛出异常;

在引入Graceful Response但是没有加入@ValidationStatusCode注解的情况下,会以默认的错误码进行返回;

在上面的UserInfoQuery中由于使用了@ValidationStatusCode注解,并指定异常码为520,则当userName字段任意校验不通过时,都会使用异常码520进行返回,如下。

{
  "status": {
    "code": "520",
    "msg": "userName is null !"
  },
  "payload": {}
}

而对于Controller层直接校验方法入参的场景,Graceful Response也进行了增强,如以下Controller。

public class Controller {

  @RequestMapping("/validateMethodParam")
  @ResponseBody
  @ValidationStatusCode(code = "1314")
  public void validateMethodParam(
          @NotNull(message = "userId不能为空") Long userId,
          @NotNull(message = "userName不能为空") Long userName) {
    //省略业务逻辑
  }
}

如果该方法入参校验触发了userId和userName的校验异常,将以错误码1314进行返回,如下。

{
  "status": {
    "code": "1314",
    "msg": "userId不能为空"
  },
  "payload": {}
}
2.2.6 自定义Response格式

Graceful Response内置了两种风格的响应格式,并通过graceful-response.response-style进行配置。

graceful-response.response-style=0,或者不配置(默认情况),将以以下的格式进行返回:

{
  "status": {
    "code": 1007,
    "msg": "有内鬼,终止交易"
  },
  "payload": {
  }
}

graceful-response.response-style=1,将以以下的格式进行返回:

{
        "code": "1404",
        "msg": "not found",
        "data": {
        }
        }

如果这两种格式均不满足业务需要,Graceful Response也支持用户自定义响应体,关于自定义响应体的技术实现,请到自定义Response格式进行了解。

本项目提供的进阶功能,包括

  • 第三方组件汽车(Swagger、执行器等)

  • 自定义响应

  • 异常请求放行

  • 异常别名

  • 常用配置项

目前该组件在GitHub上已经有两百多Star,很多朋友已经开始用了,大家可以通过下方链接了解下:

  • https://github.com/feiniaojin/graceful-response


欢迎加入我的知识星球,全面提升技术能力。

👉 加入方式,“长按”或“扫描”下方二维码噢:

979567d766f6bc1dcbf5fa5718903313.png

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。

a618e66ddd880f997a5036033a550c48.png

7205747c12d803db5831f00e9ec34e10.png863e38b98066b4a68b4e4c12682d1d94.png9c8fc992047d96a43b39732c07341215.png84ef60f8cd0af25e4750c23a8919434f.png

文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
线上OOM别慌!手把手教你用HeapHero分析JVM的hprof文件(附实战Demo) 本文详细介绍了如何使用HeapHero工具快速分析JVM的hprof文件,定位线上OOM问题。通过实战案例和Demo演示,帮助开发者在紧急情况下30分钟内锁定内存泄漏源头,并提供防御性编程建议,有效预防OOM发生。 阅读详情

相关推荐

DeepSeek技术路线图:从可复现模型到生产级AI工程实践

大语言模型(LLM)的真正价值不在于参数规模或理论性能,而在于能否稳定、可控、高效地融入真实业务系统。这涉及模型架构设计、推理优化、安全对齐与基础设施统一等多维协同。DeepSeek通过领域专用模型、MoE工业级确定性路由、规则引导式奖励建模等关键技术,将‘可用性’定义为显存可测、延迟可控、合规可验的核心指标。其开源模型普遍支持4-bit量化部署、32K上下文动态管理及编译器感知分词,在金融文档解析、代码补全、RAG服务等场景已验证SLA级稳定性。本文基于实测数据与代码级分析,揭示如何将前沿AI研究转化为可

weixin_34122532的博客 313

Graceful Response 构建 Spring Boot 下优雅的响应处理

当抛出异常时我们希望根据不同的异常返回不同的错误码,在中为我们提供了注解,可以快速的指定返回的错误码和提示。@ExceptionMapper(code = "1003", msg = "自定义异常", msgReplaceable = true)super();@Slf4j/*** 返回对象形式*///具体逻辑// ....// 抛出异常/*** Command 形式*///具体逻辑// ....// 抛出异常。

小毕超博客 2835

Strands+AgentCore构建可交付AI协作生产系统

AI多智能体系统并非简单调用多个大模型,而是需解决协作编排、上下文治理与生产可观测性等工程化核心问题。其原理在于通过工作流引擎(如Strands)实现Agent间有状态、可干预的协同节奏,结合运行时封装(如AgentCore)提供标准化API、权限控制与OpenTelemetry原生监控。该技术路径显著提升AI输出的一致性、可审计性与成本可控性,适用于需向客户交付结构化AI服务的企业级场景,尤其适合正从Prompt Engineering迈向Agent工程化落地的技术团队。

weixin_30527323的博客 306

2024 java使用Graceful Response,告别自己去封装响应,可以接收数据异常,快看我这一篇,足够你用!

2024 java使用Graceful Response,告别自己的封装响应,看我这一篇,足够你用!

m0_47484034的博客 1273

从Notebook到生产:机器学习模型服务化实战指南

机器学习模型服务化是将训练好的模型稳定、可靠、可观测地部署至线上环境的关键工程实践。其核心在于突破本地开发幻觉,通过分层架构(服务层/模型层/数据层)实现解耦,依托Triton等专用推理服务器提升吞吐与稳定性,并以数据契约和KS检验应对数据漂移。技术价值体现在低延迟、高可用、可回滚与故障可归因,广泛应用于金融风控、工业预测性维护、实时推荐等高要求场景。本文聚焦模型服务化落地中的硬核配置、在线监控、API设计与可观测性协同,直击生产环境真实卡点。

weixin_34021089的博客 392

【项目实战】Graceful Response是Spring Boot 技术栈下的优雅响应处理组件,核心目标是解决后端接口开发中“响应格式不统一、异常处理冗余、错误码管理混乱”三大痛点

隐藏timestamp字段。自定义成功默认错误码(如将 200 改为 0)。自定义响应字段名(如将code改为errorCode// 1. 定义业务异常(继承组件提供的基础异常类)// 关联错误码:1001,错误信息:用户不存在super(1001, "用户不存在");// 2. Controller 中直接抛出,无需处理// 直接抛出// 3. 组件自动返回响应"message": "用户不存在",系统错误码:1000~9999(如 500:系统内部错误、400:参数错误)。

奶爸的编程之路,也就一周冷个三天 245

拒绝加班!这款高效 SpringBoot 组件,3分钟拉满生产力~

全新前后端微商城项目,手把手教学!全新前后端微商城项目,手把手教学!全新前后端微商城项目,手把手教学!Graceful Response是一个Spring Boot技术栈下的优雅响应处理器,提供一站式统一返回值封装、全局异常处理、自定义异常错误码等功能,使用Graceful Response进行web接口开发不仅可以节省大量的时间,还可以提高代码质量,使代码逻辑更清晰。强烈推荐你花3分钟学会它!本...

MarkerHub的博客 223

打造Spring Boot优雅响应神器:一文解锁Graceful Response设计秘籍

对于成功的响应,可以通过一个辅助方法来简化构造。Java3 return new GracefulResponse(HttpStatus.OK.value(), "操作成功", data);4 }5}通过上述设计,"Graceful Response"虽为概念性的描述,但我们构建了一个实用的响应处理框架,它确保了API响应的一致性,提升了用户体验,同时简化了错误处理逻辑,增强了系统的可维护性和扩展性。在Spring Boot应用中,这样的设计可以显著提升开发效率和应用的健壮性。

java专栏 659

线上生产大文件下载导致 OOM,顺藤摸瓜拿下

线上问题排查

浩浩的博客 557

从理论到实践:全面解析Cmk(设备能力指数)的应用与优化

本文全面解析了设备能力指数Cmk的核心概念、计算逻辑与关键应用场景。Cmk作为衡量设备本身固有加工能力的黄金标准,在设备验收、大修后验证及过程能力根因分析中至关重要。文章通过实战案例,详细阐述了执行Cmk测试的“五大固定”黄金法则、数据计算分析方法,并提供了Cmk不达标时的系统性排查与优化策略,帮助制造企业实现预防性质量管理。

jump7的博客 533

ENVI5.6 批量处理GF-2/GF-6/GF-7:从安装到融合的完整自动化流程

本文详细介绍了ENVI5.6环境下批量处理GF-2/GF-6/GF-7卫星数据的完整自动化流程,包括环境配置、工具安装、正射校正、图像融合等关键步骤。通过实战案例和优化技巧,帮助用户高效完成高分卫星影像处理,提升工作效率。特别针对GF-6和GF-7的特殊处理要点进行了深入解析。

weixin_42546392的博客 179

火山引擎MARS-APM Plus x 飞书 |降低线上OOM,提高App性能稳定性

通过使用火山引擎MARS-APM Plus的memory graph功能,飞书研发团队有效分析定位问题线上case多达30例,线上OOM率降低到了0.8‰,降幅达到60%。大幅提升了用户体验,为飞书的性能品质保驾护航。 应用程序稳定性是影响用户体验及留存的关键因素 对于移动App的开发者来说,最基础也是最关注的问题就是应用程序的稳定性。而崩溃问题是影响稳定性的重要因素, 包括NSException、Signal、卡死、OOM(Out Of Memory)等问题类型。其中,OOM问题是随着业务的迭代,慢慢.

YZcoder的博客 1451

华为设备有关用户名密码的策略配置

命令用来开启对密码进行复杂度检查功能,设备默认已经是开启状态。1、密码长度大于等于12位,含数字大小写字母和特殊符号。2、设置密码更换周期为90天。取值范围8-16,默认长度为8位。登录失败后锁定时间大于15分钟。3、登录失败次数小于5次。4、登录超时30分钟以内。

简单的创作,希望可以帮助到跟我一样的学习者! 7841

一次线上OOM的深度复盘:从dump文件到代码死角的追踪

本文深度复盘了一次线上OOM故障的排查全过程。通过分析dump文件,定位到海量UserQueryResult对象实例,并顺藤摸瓜,结合线程堆栈分析,最终发现是由于MyBatis-Plus查询条件参数校验缺失,导致全表扫描引发内存溢出。文章详细介绍了从保护现场、工具使用到代码修复的完整思路与最佳实践。

swift5iosmith的博客 199

基于STM32与MPU6050的实时姿态检测系统设计与实现(源码+硬件解析)

本文详细介绍了基于STM32单片机与MPU6050传感器的实时姿态检测系统设计与实现。通过硬件解析、传感器校准、卡尔曼滤波算法和欧拉角计算,实现高精度姿态检测。提供完整源码和调试技巧,适用于无人机、平衡车等嵌入式开发项目,解决噪声干扰和数据漂移等常见问题。

jupi8的博客 497

工业级向量检索核心技术:IVF-PQ原理与全流程解析

在大规模高维向量检索场景中,IVF-PQ(倒排索引结合乘积量化)凭借“粗筛范围+细算距离”的双重加速策略,成为核心解决方案。本文将深入解析其原理与全流程,助力开发者掌握这一关键技术。

进一步有进一步的欢喜~ 1199

DevOps系列之生产Java问题常见排查

Java生产环境故障排查与性能分析指南摘要 核心工具: HPROF文件分析OOM问题 堆内存快照,记录对象实例、引用关系 使用MAT工具分析泄漏报告/支配树/直方图 重点排查Retained Heap大的对象 JFR文件分析性能问题 低开销持续记录JVM运行数据 使用JMC分析CPU热点/线程阻塞/内存分配 支持按症状选择分析路径(CPU高/响应慢/GC频繁) 关键技巧: OOM问题查支配树找内存黑洞 CPU问题查方法采样热点 响应慢问题查线程阻塞原因 内存分配问题查TLAB分配 常用工具:MAT、JMC、

xiao_1xu的博客 1310

华为od 面试八股文_Python语言_01_含答案

华为od 面试八股文_Python语言_01_含答案

MISAYAONE的博客 9134

Android 内存暴减的秘密?!

在 我这样减少了26.5M Java内存! 一文中内存优化一期已经告一段落,主要做的事情

wetest_tencent的博客 1646

基于 Logistic 混沌映射和 Arnold 变换 的变换域水印改进算法【高级网络与信息安全技术-信息隐藏期末课程论文】

摘要:\textbf{摘要:}摘要:本文提出了一种新的水印算法是一种图像认证的新方法。算法首先使用Logistic混沌映射加密水印图像,然后使用Arnold变换置乱水印。同时改变了水印图像的像素位置和像素值,大大提高了算法的安全性。再使用DCT变换嵌入水印,并且结合人类视觉系统的特点来提升水印嵌入的透明性。实验结果表明,本文提出的水印算法可以大幅度提高水印嵌入的透明性与安全性的同时,并不降低算法的鲁棒性。注:完整的代码和论文在文末,百度网盘链接。

zik的博客 894

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

上一篇: 盘点Lombok的几个骚操作
下一篇: 拒绝写重复代码,试试这套开源的 SpringBoot 组件,效率翻倍~
公众号-芋道源码
博客等级 码龄10年 1637粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值