技术文章

踩坑实录、问题解决、工具技巧——持续积累的开发经验

全部 踩坑实录 问题解决 工具技巧
🔧 问题解决
配置改了却不生效?先用 Diff 确认改动到底落没落上去

配置改了不生效怎么排查?本文给出三步定位法:先用文本 Diff 确认改动是否落上去,再用 nginx -T 等命令确认改的是实际加载的文件,最后区分多实例与缓存场景,附一次 Nginx 超时配置被覆盖的实战复盘。

🔧 问题解决
Nginx 504 Gateway Timeout 排查:先分清是谁超时,再改超时配置

Nginx 504 Gateway Timeout 怎么排查?本文按日志字段区分客户端超时与上游超时,讲解 proxy_read_timeout 三件套的真实含义与优先级、keepalive 未生效导致连接打满,以及后端慢 SQL、连接池耗尽的定位方法。

⚠️ 踩坑实录
Redis 缓存命中率只有 60%?先分清穿透、击穿和泄漏

Redis 缓存命中率低怎么排查?本文讲解 INFO stats 正确算法与重启归零陷阱、TTL -1 泄漏与 -2 缺失的判断、热 key 与大 key 扫描方法,以及缓存穿透、击穿、雪崩、泄漏四种问题的区分与处理方案。

🔧 问题解决
Pod 一直 CrashLoopBackOff?按 Exit Code 5 分钟定位

Kubernetes Pod 处于 CrashLoopBackOff 怎么排查?本文按 kubectl describe 事件、--previous 日志、容器 Exit Code(137 OOMKilled / 143 SIGTERM / 1 应用异常)三步定位,附存活探针与资源限制的常见配置错误。

💡 工具技巧
用 curl 调试接口:8 个参数覆盖 90% 的联调场景

curl 调试 REST 接口的 8 个高频参数与实战:-v 看完整请求链路、-I 只看响应头、-G --data-urlencode 处理中文参数、-F 上传文件、-b/-c 复用 Cookie,附 401、字段全空、超时三类问题的排查步骤与 Windows 引号坑。

⚠️ 踩坑实录
git log 中文全是 <E6><89> 转义?Windows 下 Git 乱码根治实录

git log 中文显示为 <E6><89> 十六进制转义或涓枃乱码?本文按 Git 输出链路拆解根因:core.quotepath 与 i18n 配置、less pager 的 LESSCHARSET、控制台 chcp 65001 代码页,附完整修复步骤与验证方法。

🔧 问题解决
Git 误操作急救:reset / revert / stash 三种场景与恢复步骤

Git 提交错了怎么撤销?本文按未 push 用 reset、已 push 用 revert、临时切换用 stash 三种场景给出急救命令,并用 git reflog 兜底找回误删提交,附完整命令示例。

🔧 问题解决
Docker 磁盘占用暴涨?镜像、容器与构建缓存清理全流程

Docker 磁盘占用越来越高?本文讲解 docker system df 定位方法,镜像、构建缓存、容器、数据卷逐项清理命令,system prune 的风险边界,以及日志句柄不释放等常见坑的处理。

🔧 问题解决
Linux 磁盘满了怎么排查?df / du / find 三步定位大文件

Linux 磁盘满排查三步法:df -h 定位分区、du 逐层下钻、find 按大小和时间抓大文件,附 inode 耗尽、文件已删未释放、du 与 df 不一致等经典坑的解决方案。

⚠️ 踩坑实录
Maven 依赖冲突排查实录:dependency:tree 与 exclusions 实战

Maven NoSuchMethodError 怎么排查?本文讲解 dependency:tree 定位冲突路径、Maven 版本仲裁规则、dependencyManagement 与 exclusions 两种解法,以及 enforcer 插件 dependencyConvergence 防回归配置。

⚠️ 踩坑实录
URL 编码与中文乱码排查:+ 号、%20 与双重编码

URL 中文参数乱码、加号变空格怎么排查?本文讲解 URL 编码规则、+ 与 %20 的表单编码历史包袱、双重编码的判断方法,以及 DevTools 逐环节排查四步法和 Java 正确编码姿势。

💡 工具技巧
DXTool 命令面板 + 凭据保险库:5 分钟上手本地效率组合

大雄工具 DXTool 命令面板与凭据保险库上手指南:模糊搜索秒开命令、AES-256-GCM 本地加密存密码,5 分钟搞定 Windows 本地效率组合。

🔧 问题解决
删除文件提示"文件被占用"?Restart Manager 原理与 5 种解除方法

删除文件提示"文件已在另一个程序中打开"的解决方案:讲解 Windows Restart Manager 原理,对比 DXTool、资源监视器、Handle.exe 等 5 种解除文件占用的方法。

🔧 问题解决
Windows 端口被占用怎么办?netstat、PowerShell、工具排查三种方式对比

Windows 端口被占用(Port already in use)的三种排查方法对比:netstat+tasklist、PowerShell Get-NetTCPConnection、DXTool 占用排查工具,附命令示例与适用场景。

⚠️ 踩坑实录
JSON 转 Java 实体的 5 个坑:日期、枚举、嵌套泛型怎么处理

JSON 转 Java 实体类常见 5 个坑:日期字符串格式化、null 值类型推断、金额 double 精度、混型数组、动态 key 与嵌套泛型,附 Jackson 注解解决方案。

⚠️ 踩坑实录
CSV 导出后用 Excel 打开中文全是乱码?BOM 问题排查实录

CSV 文件用 Excel 打开中文乱码的根因与修复:Windows Excel 依赖 BOM 识别 UTF-8,导出时在文件头写入 EF BB BF 即可,附 Go/Java 代码示例与防回归测试。