背景 SOAP（Simple Object Access Protocol）是上世纪的远程调用协议，基于 XML，通常走 HTTP 传输。虽然现在 RESTful API 和 gRPC 已经是主流，但一些政府、金融、国企的老系统仍然只提供 SOAP / Web Service 接口。 对接这类接口时，传统做法是引入 CXF、Axis2 等 SOAP 框架，通过 WSDL 生成客户端代码。但如果你只是偶尔调一两个接口，引入几百 MB 的依赖、增加部署体积，实在没必要。 实际上 SOAP 本质上就是一个 带特定 Con…
一、问题的前因后果 如果你是 Java 后端开发，日常用 Maven 管理项目，手头维护或参与的项目又比较多，大概率会遇到这样的情况：某天打开磁盘占用分析工具，发现 ~/.m2/repository 这个文件夹已经悄悄涨到了几十 GB。 原因也很好理解： 每个项目的依赖版本可能不一样，Maven 不会自动清理旧版本，只会不断"新增"； 项目迭代过程中依赖升级（比如 SpringBoot 从 2.x 升到 3.x），旧版本的一堆 jar 包永远留在仓库里； 参与过的临时项目、POC 项目、已经归档不再维护的项目，它们…
在内容型 Web 系统（新闻/文章/活动/公告）中，一个高频问题是： 页面在浏览器里显示正常，但分享到微信、Slack、飞书、Twitter、Facebook、LinkedIn 后，卡片标题、摘要、封面图错误或缺失。 很多团队第一反应是“前端动态改 <meta> 就好”，但在 SPA（Vue/React）里这通常不可靠。本文从工程角度给出一套可落地方案： 后端动态注入 meta，结合 Nginx 路由与缓存策略，稳定兼容主流抓取器。 一、问题根因：浏览器用户 vs 抓取机器人看到的不是同一阶段内容 1）…
问题背景 在 Vue 3 单页应用（SPA）开发中，我们经常遇到这样的场景： 用户正在使用网站（比如在留言页面填写内容） 我们发布新版本，将新的 dist 文件部署到服务器 用户继续操作，点击页面内的路由链接 结果：页面无法跳转，控制台出现类似 ChunkLoadError 或 Loading chunk X failed 的错误 用户困惑：不知道发生了什么，只能手动刷新浏览器 这是典型的 动态导入（Dynamic Import） Chunk 加载失败 问题。当新版本部署后，服务器上的旧文件已被替换，用户浏览器缓存…
一、问题背景 最近在本地调试一个老项目时，发现一个非常奇怪的现象： 同一套 Oracle 数据库 线上环境访问正常、执行很快 本地开发环境访问却非常慢 换到另一个 Spring Boot 项目 访问同一库，速度又是正常的 也就是说： 问题只出现在这一个老项目的本地环境中，同库、同网络条件，别的项目没问题。 这类问题最容易让人误判到 “网络”、“数据库本身”、“SQL 写得烂”等方向。 但既然同样的 SQL、同一个库、在其他项目里是快的，那基本可以锁定是 “项目自身的配置或技术栈造成的性能问题”。 下面按照时间线，记…
在 Spring 项目里用 RestTemplate 调外部接口，本来是个很日常的需求，但一旦遇到 PATCH 方法，就很容易踩坑。 这篇笔记整理下从报错到解决的完整过程，方便自己和同事以后少掉坑。 一、问题场景与报错现象 业务需要调用外部接口： URL 形如：https://example.com/api/v1/resource/{id} HTTP 方法：PATCH 请求体：JSON 代码大致是这样的： ResponseEntity<String> response = restTemplate.ex…
线上排查问题时，常见的几个灵魂拷问： “这台机器上的 JAR 到底是不是最新的？” “现在跑的是哪个版本？” “这个版本对应哪次 Git 提交？” 如果我们能在应用启动时，就统一打印出“构建时间 + 版本号 + Git commit 信息”，排查问题会轻松很多。 本文基于 Spring Boot 的能力，给出一个比较优雅的实现方案： 利用 spring-boot-maven-plugin 生成 build-info 可选地利用 git-commit-id-plugin 写入 Git 提交信息 启动时从类路径里读取 …
问题背景 在 Web 应用中，当我们通过后端接口向浏览器返回 PDF 文件供用户在线预览时，常常希望浏览器标签页能显示一个有意义的标题，而不是文件的原始名称或 URL 路径。这对于提升用户体验、帮助用户快速识别正在查看的文档内容非常重要。 问题现象 许多开发者会尝试通过设置 HTTP 响应头来控制标签页标题，典型的做法包括： Content-Type: application/pdf Content-Disposition: inline; filename="MyDocument.pdf" 然而实际运行时会发现：…
前言 在现代 Web 应用中,图片上传是一个非常常见的功能。然而,用户上传的原图往往尺寸很大(动辄几MB甚至十几MB),直接上传会带来诸多问题: 网络传输慢:大文件上传耗时长,用户体验差 服务器压力大:存储和处理大量高清图片消耗资源 加载速度慢:展示时需要加载大图,影响页面性能 因此,在前端对图片进行压缩处理成为了一个最佳实践。本文将介绍一个实用的图片压缩方案,并详细解析其实现原理。 核心需求 我们需要实现一个函数,能够: 接收图片 Blob 对象作为输入 对图片进行等比缩放(不超过指定的最大宽高) 压缩图片质量 …
问题背景 在使用Thymeleaf生成PDF文档并嵌入图片时,我遇到了一个常见但棘手的问题:某些图片在PDF中显示时会出现方向错误,最典型的是竖拍的照片会横着显示。 问题根源 这个问题的根本原因在于EXIF(Exchangeable Image File Format)方向信息的处理。现代智能手机和数码相机在拍摄照片时,会在图片文件中记录拍摄时的设备方向信息(EXIF Orientation标签)。然而,图片的实际像素数据可能并没有真正旋转,而是依靠EXIF信息告诉显示软件应该如何旋转显示。 大多数图片查看器和浏览…
