标签

SpringBoot

共 60 篇文章。看完整归档 →

2026-07-161 分钟

从 0 到 1 拆解一个 Netty IM 长连接服务:网关路由、在线路由与消息投递设计

前言 很多项目一开始做“实时消息”时,最容易把问题想简单:前端连一个 WebSocket,后端收到消息再转发出去,好像就完成了一个 IM 服务。 但真正落到微服务架构里,问题会立刻变多: 1. 客户端长连接应该接到哪里? 2. 网关怎么转发 WebSocket…

2026-06-121 分钟

一次 Excel 导入导出引发的 OOM 排查与优化记录

一、问题背景 最近在排查服务内存上涨和 OOM 风险时,发现部分批量导入、错误 Excel 回写相关代码存在较明显的内存和资源管理问题。 业务场景大致是: 1. 用户上传 Excel 文件。 2. 系统读取 Excel 内容并转换成业务 DTO。 3. 校验每…

2026-04-191 分钟

记一次 RabbitMQ 消息已入队但 Spring Boot 消费者始终未消费的排查过程

问题现象:接口提示发送成功,但邮箱始终收不到验证码 这次排查的问题来自认证服务 的邮箱验证码发送功能。 前端调用发送验证码接口后,接口返回一切正常: 服务端日志里也能看到生产者执行成功: 但是邮箱就是收不到邮件,而且消费者侧没有任何消费日志。 第一直觉很容易怀…

2026-04-191 分钟

记一次 QQ 邮箱 SMTP 鉴权失败与频率限制的排查优化

问题现象:验证码接口成功,但邮箱发送并不稳定 在认证服务 中,邮箱验证码链路已经打通: 1. 前端调用发送验证码接口 2. 后端将验证码消息投递到 RabbitMQ 3. 消费者异步发送邮件 最开始排查时,接口返回一直是成功的: 生产者日志也显示一切正常: 但…

2026-03-121 分钟

彻底解决 Spring Cloud 项目中 LOG_PATH_IS_UNDEFINED 问题的“玄学”方案

在开发基于 Spring Cloud 的微服务时,你是否遇到过这样的怪事:项目启动后,在根目录下莫名其妙多出了一个名为 或 的文件夹? 虽然程序运行没问题,但这文件夹看着确实闹心,而且生产环境下的日志往往无法按预想路径存储。今天我们就来拆解这个问题的底层逻辑,…

2025-12-251 分钟

Go 与 Java 微服务时间格式兼容问题排查与解决

前言 在微服务架构中,不同语言编写的服务之间通过 HTTP/JSON 进行通信是常见场景。本文记录了一次 Go 服务与 Java 服务之间因时间格式不兼容导致的反序列化失败问题,从问题现象、排查过程、根因分析到最终解决方案,完整呈现整个处理链路。 系统架构 -…

2025-12-201 分钟

ip2region 升级支持 IPv6 地址解析

问题背景 线上日志出现 IPv6 地址解析异常: 问题原因 旧版 的 方法内部 只支持 IPv4 格式(如 ),对于 IPv6 格式会直接抛出异常。 解决方案 升级到 ip2region 新版 API(3.0.0+),使用 服务类,原生支持 IPv4/IPv6…

2025-12-191 分钟

Maven 多模块项目子模块单独打包失败问题

问题描述 在多模块 Maven 项目中,使用 IDEA 可以正常打包,但在命令行中进入子模块目录单独执行 时报错: 错误信息: 问题原因 1. Maven 多模块依赖解析机制 当你在子模块目录下直接执行 时: - Maven 只能看到当前子模块的 - 无法正确…

2025-09-171 分钟

解决:SpringClould Feign 报错 Request method 'POST' not supported

问题 解决 如果 openFeign 代理的是 get 请求,则每个参数必须带上 @RequestParam,否则会报 或者可以使用这个注解 @SpringQueryMap

2025-09-171 分钟

解决异常:ShiroRequestMappingConfig required a single bean, but 2 were found...

问题 在将 Shiro 2.0.1 与 Spring Boot 3(Jakarta EE)和 Actuator 集成时,可能会遇到如下启动报错: 意思就是 ShiroRequestMappingConfig 这个类需要 RequestMappingHandle…

2025-09-161 分钟

解决异常:fastjson 序列化与反序列化集合时出现问题

问题背景 在实现配送设置业务时,遇到一个比较奇怪的情况: - 如果我在配置服务里直接调用接口,本地测试一切正常。 - 但当 订单服务 通过 OpenFeign 调用该接口时,却报了 序列化异常,接口调用失败。 问题接口返回的 VO 如下(报错方法:getDel…

2025-05-131 分钟

解决异常:打开swagger文档遇到For input string: ""的报错

前言 最近做的一个项目,使用新的是 swagger 加强版 地址: 打开文档时遇到 java.lang.NumberFormatException: For input string: "" 的异常,原因是swagger文档上每个参数都会设定一个默认值,包装类…

2025-04-271 分钟

解决异常:生成小程序海报二维码报错:invalid page rid: xxxx

问题 最近新增的业务调用之前封装的生成小程序二维码接口发生错误: 参考官方文档: 解决 由于之前其他业务页面都是成功的,只有这个新增的页面是失败的,对比了下数据后,发现是前端传来的path部分带有 前缀,如:,我们只需要处理前缀就好了,比如:,重新调接口生成发…

2025-04-211 分钟

Spring Boot 集成 Spring AI 框架

一.Spring AI介绍 Spring AI 是一个用于 AI 工程的应用程序框架。 其目标是将 Spring 生态系统设计原则(如可移植性和模块化设计)应用于 AI 领域,并将使用 POJO 作为应用程序的构建块推广到 AI 领域。 Spring AI 的…

2025-04-201 分钟

Java 实现 Github 第三方登录详解

创建一个Github应用 1. 点击 Github 头像 2. 然后点击设置 3. 进入设置后,往下划,点击开发者设置 4. 然后点击 Oauth apps 5. 可以看到其中有几个必填项 6. 下面是一个填写示例: 全部填写好后我们成功创建了一个 Githu…

2025-02-191 分钟

Spring Boot 常用内置工具类汇总

前言 SpringBoot 内置了许多工具类,但偶尔仍能看到同事重复发明类似功能。相信他们并非故意重复造轮子,而是可能不熟悉现有工具。接下来我将分享一些常用的工具类,帮助大家高效开发。 1、断言 1. 断言用于检查程序中不应该出现的情况,属于一种逻辑判断。 2…

2025-02-101 分钟

解决异常:Spring 异步任务操作请求对象报错 No thread-bound request found

问题 在对某个接口进行异步优化时,遇到了如下异常: 其实这个问题报错后,一下子就能想到应该是线程上下文相关的问题,而这个问题是:在异步线程中需要访问主线程中的 HttpServletRequest 对象时,由于异步线程没有绑定到当前的 HTTP 请求,导致请求…

2025-02-101 分钟

Spring Boot、Spring Cloud 与 Spring Cloud Alibaba 版本对应关系

1、简介 Spring Cloud Alibaba 是阿里巴巴开源的一套微服务解决方案,旨在帮助开发者快速构建基于 Spring Cloud 体系的分布式应用。它整合了阿里巴巴内部经过大规模验证的基础设施组件,如 Nacos、Sentinel、RocketMQ…

2024-09-301 分钟

SpringBoot 整合 xxl-job

前言 在微服务和分布式系统中,任务调度是一个重要的功能。无论是定时任务、批处理任务,还是分布式任务,如何高效、稳定地调度和管理任务对于系统的性能和扩展性至关重要。xxl-job 作为一款轻量级的分布式任务调度平台,具有简单易用、支持分布式、丰富的任务管理功能,…

2024-07-201 分钟

Java 接入苹果登录

前言 为什么要用苹果登录?在国内大多数人应该都是使用的微信登录或者手机号一键登录多一些。之所以要开发苹果登录,可能大多是因为苹果的霸王条款:要求只要在苹果商店上架的应用,凡是接入了其他第三方登录,必须接入苹果登录。 苹果登录涉及非对称加密、JWT、第三方登录,…