踩坑实录

踩坑实录:记录开发中真实遇到的报错、乱码和结果不对的问题,从现象描述、排查步骤到根因分析和最终修法完整复盘,附可复制的命令与代码。每篇说明什么情况下容易触发、上线前怎么提前避开,遇到类似报错可以直接对照,少走重复排查的弯路。文章不堆结论,重点写清怎么复现、怎么验证修法是否真的生效,避免下次再踩同一个坑。

全部 踩坑实录问题与疑难工具技巧
Linux 定时任务踩坑:为什么脚本跑了但日志没写
Linux 定时任务踩坑:为什么脚本跑了但日志没写

crontab 脚本跑了但日志没写?文章列出 7 个原因:输出被 cron 丢弃、PATH 环境变量不全、工作目录不对、% 未转义、脚本没有执行权限、CRLF 换行导致 shebang 失效、定时任务根本没触发。每条给出验证方法与修复写法,附日志重定向与环境变量加载的完整示例,也说明 systemd timer 写法。

2026-10-30 阅读约 13 分钟
时间戳转日期:Java 的 Instant/LocalDateTime 转换 5 个坑
时间戳转日期:Java 的 Instant/LocalDateTime 转换 5 个坑

时间戳转日期的 5 个坑:10 位秒与 13 位毫秒怎么判断、Instant 与 LocalDateTime 的时区层级、ZonedDateTime 何时才需要、新旧日期类互转的正确姿势、SimpleDateFormat 非线程安全。文章附 MySQL 时间类型与格式化写法对照,给出排查时间差 8 小时的定位顺序。

2026-10-29 阅读约 12 分钟
MD5/SHA 在线计算:同一个文件不同机器算出来为什么不一样
MD5/SHA 在线计算:同一个文件不同机器算出来为什么不一样

MD5/SHA 计算结果不一致?五个高频原因:CRLF 与 LF 换行差异、UTF-8 与 GBK 编码不同、BOM 与零宽字符不可见、大小写与空格处理不同、下载时附加了数据流。文章给出跨机器比对同一文件的具体定位方法,附命令行与代码示例,核对安装包和接口签名时按顺序排查,能避免反复下载大文件;先比对大小,再比对摘要。

2026-10-29 阅读约 11 分钟
JSON 工具避坑:从「Invalid JSON」到看懂转义字符的 3 分钟
JSON 工具避坑:从「Invalid JSON」到看懂转义字符的 3 分钟

JSON 格式化报 Invalid JSON 怎么定位?文章按三类高频坑拆解:转义字符被双重转义、粘进来时带上 HTML 实体、文档开头藏了 BOM 或零宽字符。每类给出识别与修复步骤,另附 JSON 转 Java 实体的 4 个坑:数组类型推断、日期字段、字段命名与未知字段处理。报错先看行号,再逐字符检查引号与逗号。

2026-10-29 阅读约 9 分钟
SQL 格式化踩坑:为什么格式化后 join 条件缩进全乱了
SQL 格式化踩坑:为什么格式化后 join 条件缩进全乱了

SQL 格式化 5 大坑:JOIN 条件缩进混乱、多层子查询括号看不清、CASE WHEN 的 ELSE 错位、Hint 注释被格式化破坏、方言专有语法被误改。文章说明格式化后必须重点复查的部分,给出保留 Hint 与嵌套结构的写法建议,附格式化前后的对照示例,也说明团队统一格式风格的配置项与取舍。

2026-10-29 阅读约 8 分钟
MySQL 迁 Oracle 踩坑实录:DATETIME、TINYINT、AUTO_INCREMENT 的类型映射陷阱
MySQL 迁 Oracle 踩坑实录:DATETIME、TINYINT、AUTO_INCREMENT 的类型映射陷阱

MySQL 迁 Oracle 的类型映射陷阱:DATETIME 精度丢失、TINYINT 被映射成 CHAR(1)、自增主键在 Oracle 没有对应概念、空字符串等于 NULL、分页要改写成 ROWNUM 或 OFFSET。文章附类型对照表与迁移前检查清单,给出批量改写思路与验证方法,迁移前先在测试库验证建表与查询。

2026-10-29 阅读约 13 分钟
MyBatis 查询结果莫名少字段?八成是 resultMap 里漏配了
MyBatis 查询结果莫名少字段?八成是 resultMap 里漏配了

MyBatis 查询结果缺字段?resultMap 漏配列是高频根因。文章复盘一次加字段后忘记改 resultMap、导致查询结果为空排查半天的过程,给出用 Mapper 生成器反推完整映射的写法,也说明自动映射开关、驼峰配置与列别名三者的关系,附快速自查清单,以及 Mapper XML 与注解两种写法的选择。

2026-10-29 阅读约 12 分钟
配置改了却不生效?先用 Diff 确认改动到底落没落上去
配置改了却不生效?先用 Diff 确认改动到底落没落上去

配置改了不生效怎么排查:先用文本 Diff 确认改动到底落没落上去,再用 nginx -T 看实际加载的是哪份文件,最后区分多实例、容器挂载与缓存三层原因。文章复盘一次线上改配置无效的完整过程,给出每一步的验证命令与判断依据,避免反复重启服务却找不到根因,附 nginx、Spring Boot 多环境的排查示例。

2026-10-28 阅读约 6 分钟
Nginx 504 Gateway Timeout 排查:先分清是谁超时,再改超时配置
Nginx 504 Gateway Timeout 排查:先分清是谁超时,再改超时配置

Nginx 504 怎么排查?先按日志字段分清是客户端超时还是上游超时,再确认 proxy_read_timeout、proxy_connect_timeout、proxy_send_timeout 三个参数的优先级。文章讲清 keepalive 未生效导致连接打满、后端慢 SQL 与连接池耗尽的现象,附定位顺序。

2026-10-27 阅读约 6 分钟
Redis 缓存命中率只有 60%?先分清穿透、击穿和泄漏
Redis 缓存命中率只有 60%?先分清穿透、击穿和泄漏

Redis 缓存命中率低怎么排查?先看 INFO stats 的算法口径,注意重启后计数归零的陷阱;再查 TTL 为 -1 的泄漏键与 -2 的缺失键,最后区分穿透、击穿、雪崩三类问题。文章给出热 key 与大 key 的扫描方法,附监控指标与常见误判的解释,以及热点数据预热与随机过期时间的落地写法。

2026-10-27 阅读约 5 分钟