问题背景 在 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信息告诉显示软件应该如何旋转显示。 大多数图片查看器和浏览…
问题背景 在现代Web应用开发中，PDF文件的安全性往往被忽视。然而，PDF文件实际上可能成为XSS（跨站脚本）攻击的载体，给Web应用带来严重的安全风险。 安全风险分析 PDF文件格式本身支持JavaScript脚本，这意味着恶意攻击者可以在PDF文件中嵌入恶意JavaScript代码。当用户在浏览器中打开这样的PDF文件时，特别是在Chrome等现代浏览器中，这些恶意脚本可能会被执行，导致： 跨站脚本攻击（XSS）：窃取用户的敏感信息如Cookie、Session Token等 会话劫持：劫用用户的登录会话 钓…
问题描述 在使用中文/日文/韩文等 IME 输入法进行文本输入时，用户常常需要按一次 Enter 来“确认候选文字”（结束合成），而不是提交表单或发送消息。 许多应用无差别地在 Enter 键时触发发送/提交，导致“第一下 Enter 就提交”，用户尚未完成输入即被打断，体验不佳。 复现方式 切换系统输入法为日语或中文拼音。 在聊天输入框或搜索框输入文本（处于合成状态）。 按 Enter： 期望：仅确认候选文字，上屏，不提交。 现象：直接提交/发送，导致输入中断。 根因分析 IME 输入有“合成态（composit…
在团队开发中，不同语言可能有不同的缩进规范。例如，Java 通常使用 4 个空格缩进，而 JavaScript 习惯使用 2 个空格。为了在 IntelliJ IDEA 中为某个项目统一缩进，最简单、最推荐的方式是直接在项目根目录下添加（或修改） .editorconfig 文件。 当项目包含 .editorconfig 文件时，IDE 会根据文件中的规则自动格式化代码，从而保证整个项目的缩进一致性。 下面是一个示例 .editorconfig 配置，可以同时针对 JavaScript 和 Java 文件设置不同的…
