Cursor 启动 Gradle 项目后，MyBatis 为什么突然找不到参数
同一 Spring Boot 项目换启动入口后出现 MyBatis 参数绑定错误，用 @Param 和项目级 -parameters 配置排查编译差异。
问题排查
这个分类下共有 141 篇文章。
浏览器能打开 Nexus，Gradle 发布却反复 failed to respond
Nexus 页面能打开但 Gradle 发布失败时，核对实际 Gradle JVM、Wrapper 版本和构建进程的网络环境。
MyBatis-Plus 3.4.0 映射枚举时报 No enum constant
以 MyBatis-Plus 3.4.0 的历史错误为例，核对枚举业务值、@EnumValue、包扫描和实际 TypeHandler，区分数据库与 JSON 序列化。
Mac 上装了新版 Git，为什么 git --version 还是旧版
从命令解析、Homebrew 前缀、链接冲突和 IDEA 的 Git 路径，排查安装新版后仍执行旧 Git 的原因。
缺少 MBeanServer 导致启动失败：先查 JMX 自动配置条件
Spring Boot 因缺少 MBeanServer 启动失败时，检查 JMX 自动配置条件、依赖与有效属性，区分关闭端点、关闭 JMX 和排除配置。
Mac 提示应用已损坏：先核对来源，不先关闭系统保护
按告警文案、下载来源、系统兼容性和开发者签名排查 Mac 应用无法打开，避免把关闭 Gatekeeper 当作修复。
企业微信回调验证失败：排查 Spring MVC 返回字符串多出的双引号
企业微信验证回调失败时查看原始响应字节，区分已解密字符串与 JSON 字符串，并处理统一返回包装和转换器顺序。
Minikube 拉不到镜像，后来才发现启动后整台 Mac 都断网了
还原 2021 年 Minikube 启动后宿主 Mac 断网的排查，区分镜像仓库、节点网络与宿主机网络，不泛化驱动结论。
gRPC 的连接错误与 Netty NoSuchMethodError：看运行时依赖
gRPC 接入 Netty 后出现连接关闭或 NoSuchMethodError 时，核对最终依赖树、加载来源与传输实现，而不是盲目升降级。
记一次 JVM 排障：全站检索为什么会触发频繁 GC
一次 Solr 检索触发频繁 GC 的历史排查：从 jstat、堆分析到接口冗余明细字段，并说明对象分配、响应大小与内存泄漏的区别。
WordPress 后台登录后反复跳回登录页：最后发现磁盘满了
WordPress 登录反复回到登录页的一次磁盘满故障，补充 df、inode、日志占用的只读检查与日志保留思路。
编译 Spring 5.2 源码时的 Kotlin LinkageError，最后是 IDEA 插件版本
恢复 Spring 5.2 源码在 IDEA 中编译的 Kotlin LinkageError 经历，保留旧插件升级入口，并区分 IDE 插件与 Gradle 工具链。
IDEA 只显示 compiled code，排查后发现装了两个反编译插件
IDEA 部分 class 只显示 compiled code 时，检查匹配源码、反编译插件和日志，用可恢复的单项禁用对照定位。
日期字段有 JsonFormat，返回值怎么又变成时间戳了
日期注解没变但响应变成时间戳时，追踪实际序列化入口，区分 Jackson 注解与 Fastjson 1.x 的日期格式 API。
MongoDB 聚合分页条数不稳定：先分页还是先 match
还原 MongoDB 聚合先分页再过滤导致少返回的代码，用固定数据推演说明 match、排序、lookup 与 count 的语义。
MongoDB 组合 or 条件报错：列表里为什么放进了两个 null
解释 BasicDBObject.put 返回旧值导致 $or 数组含 null，展示正确对象结构、Java 写法及查询 null 的匹配范围。
博客连不上数据库，mysqld 服务又找不到：从日志找回启动路径
还原博客数据库失联时从 unit 不存在到日志找到 mysqld 的过程，说明服务名、程序、数据与配置路径怎样分别核对。
继承 ResponseEntityExceptionHandler 后，Spring MVC 的 400 响应为什么没有正文
Spring MVC 缺少请求参数返回 400 却没有 JSON 时，检查异常解析链，并用 Spring 5.x 的指定处理方法设置响应体。
Stream 排序加了 nullsLast 仍编译失败：比较器类型写错了
用 Java 8 完整示例为 Date 字段配置 nullsLast，先排结束时间再排开始时间，并区分字段空值与元素本身为空。
Activiti 7 接入后，JSON 里的 null 为什么消失了
排查 Spring Boot 接入 Activiti 后 null 字段消失的问题，用 Jackson 包含策略恢复响应，并区分全局配置与字段注解。
一直在改跨域配置，最后发现 Axios 请求地址没写协议
从完整请求 URL 入手排查 Axios 联调，区分地址拼接、网络错误与 CORS，并用明确 baseURL 组织请求。
IDEA 跑 JUnit 报 Native memory allocation failed：问题不在 Java 堆
JUnit 的 native memory 分配失败不等于 Java 堆不足；从错误报告、测试 JVM 和 Windows 系统提交量定位分页文件问题。
CodeHub 的 GitHub 授权按钮一直灰着：一次 iPad 登录经历
记录一次 CodeHub 登录 GitHub 时授权按钮不可点击的经历，区分重试成功与确定根因。
SourceTree 网页认证成功，安装器却还在等待
保留 SourceTree 网页认证成功但安装器仍等待的真实经历，区分网页结果、本地回调与日志定位，不保证重试或等待必定成功。
Activiti TaskListener 报 null：先读最内层异常
从 TaskListener 的包装异常定位到业务空指针，区分 taskId、executionId、变量作用域和可空返回值。
Activiti 7.1.0.M6 的流程定义为什么属于另一个 application version
定位 Activiti 7.1.0.M6 的应用版本不匹配错误，找到 project.manifest.file.path 配置与固定版本的官方 manifest 示例。
Android SDK 搬到 F 盘，构建为什么还在 C 盘找
SDK 移盘后仍读取旧路径时，检查实际工程的 local.properties、sdk.dir、环境变量和所需平台组件。
老 Maven 项目在 Windows 找不到 java.lang：bootclasspath 分隔符写死了
还原 JDK 8 老项目的 java.lang 与内部 JPEG API 编译错误，解释 Windows 和 Linux 的类路径分隔符及现代 JDK 边界。
自定义登录页少了 _csrf：别把关闭保护当成修复
恢复自定义登录表单缺少 CSRF 字段的排查，给出 Thymeleaf 携带服务端 token 的表单结构，保留会话与认证检查。
IDEA 热更新时灵时不灵，先查自动编译有没有成功
DevTools 热更新失效时，先检查 class 是否成功生成，再对齐 IDEA 模块、编译目标和构建脚本中的 Java 配置。
Sharding-JDBC 插入报错后，我又踩到了 Snowflake ID 与 INT 的边界
恢复分片键 Comparable 错误到 Snowflake ID 超出 INT 范围的连续排障，补齐整数范围、显示宽度与前端精度边界。
Sharding-JDBC 启动时报 NumberFormatException: YES：一次版本兼容问题
恢复 Spring Boot 2.1.4、Sharding-JDBC 4.0.0-RC3 与 MySQL 驱动 8.0.15 的 YES 解析错误，沿元数据堆栈定位版本边界。
Sentinel 部署到 Kubernetes 后，实时监控为什么一直空白
分析 Sentinel 在 Kubernetes 中限流生效却监控为空的历史案例，区分心跳和指标拉取方向及实例地址可达性。
Elasticsearch 空索引排序报错：该检查的是字段 mapping
日期排序遇到缺失 mapping 时，理解 unmapped_type 的作用，并区分空索引、缺字段和跨索引类型冲突。
PageHelper.startPage 调了，查询怎么还是返回全部数据
排查 PageHelper.startPage 无效时，检查核心库与 Starter 接入、目标 SqlSessionFactory 插件及紧随其后的查询。
高亮成了一个字一个标签，就能断定分词器错了吗
高亮被切成逐字标签时，通过 mapping、字段分析和实际查询检查分词链，而不只看高亮 HTML 判断根因。
Elasticsearch 高亮字段为空：一次与 fuzziness 设置相关的排查
ES 7.4 中命中却没有高亮的一次经历：移除 fuzziness 后恢复，但仍应对比实际 DSL、mapping 和 highlighter。
Homebrew 安装连接超时：下载失败不等于安装脚本有错
Homebrew 安装获取脚本超时时，先区分 DNS、连接、TLS 和下载阶段，再使用可信官方入口，避免执行过时安装器副本。
Gateway 没直接引入 Web Starter，冲突依赖是 common 带进来的
响应式 Gateway 通过 common 模块间接引入 Web Starter 时，用依赖树定位路径并在对应 dependency 上配置 exclusion。
同一个操作第二次才报 JSON 错误，最后发现 FormData 没换
FormData 的 append 会累积同名字段，复用对象可能使第二次提交与第一次不同；用 getAll 检查并按请求创建实例。
Elasticsearch REST 客户端报不是 HTTP 端口：先核对协议与监听器
RestHighLevelClient 收到 This is not an HTTP port 时，核对 HTTP(S)、Transport 与代理转发，不能只按端口数字替换。
IDEA 能运行，java -jar 却 ClassNotFound：依赖模块也被重打包了
解释 Spring Boot 可执行 JAR 的 BOOT-INF 布局为何不适合作普通库依赖，并给出拆公共模块与 exec classifier 的选择。
公众号回复链接在安卓上变成纯文本：补上 URL 协议后的旧记录
保留公众号自动回复链接的跨设备排障经历，说明缺少协议的地址属于相对 URL，并区分消息格式与网页 HTML。
RabbitMQ 队列有消息，Zipkin 却不接收：先看消费者有没有启动
区分 Zipkin 的 RabbitMQ collector 与客户端 sender，恢复 2.15.0 历史启动配置，并按队列、消费者、解析与查询分层排查。
三次 No route info：RocketMQ 路由错误不能只看自动建 Topic
还原三次 RocketMQ 4.x 无路由故障，按 NameServer、Topic 路由、Broker 上报地址和依赖版本排查，不依赖自动建 Topic。
Excel 2010 每次打开都弹配置窗口：一个 WPS 设置的线索
记录 Office 2010 与 WPS 共存时反复出现配置弹窗的一次处理，保留历史菜单路径及恢复边界。
ES 7.3 脚本报错：脚本放在哪里，与字段是什么类型
在 ES 7.3 中分别处理脚本 file 参数错误和 tags 列表更新错误，用 source、存储脚本 id 与 add 明确请求和数据类型。
Elasticsearch 7 的两个 type 报错：旧请求格式还没改完
理解 ES 7 的 typed/typeless 过渡：更新 mapping 的 include_type_name 报错与写入时多个 type 冲突应分别处理。
接入 Zipkin 时遇到 Prometheus 标签冲突：先分清指标与链路
从同名 Prometheus meter 的标签键冲突出发，区分指标注册和 Zipkin 链路采样，避免靠停用自动指标掩盖问题。
Zipkin 启动卡在 armeriaServer：保留版本组合比复制整段堆栈更有用
恢复 Zipkin 2.12.9 与 Armeria 自动配置空指针的版本证据，核对 2.12.6 引擎迁移，并区分降级绕过与根因定位。
Hadoop 上传成功，下载却跳到 localhost：一次主机名映射排查
Hadoop 下载跳到 localhost 时，从浏览器跳转、节点名称和各机器的主机名解析查起，不把删除 IPv6 配置当作通用修复。
外层接口改成 POST 仍无效：真正过大的请求是 SolrJ 发出去的
恢复 SolrJ 大参数连接重置的两跳排查及 FieldAnalysisRequest POST 示例，区分请求重置与随后出现的空指针。
Apollo 配置已经更新，数据库连接为什么还用旧配置
区分 Apollo 配置更新、Spring 属性绑定和连接池生命周期，给出监听变化、验证新连接与安全切换的处理流程。
Spring Boot DevTools 重启后找不到 MyBatis Mapper：classpath 与 classpath* 的差别
结合旧 Spring Boot DevTools 与 MyBatis 排障，区分 IDE 编译、重启类加载器、mapper 资源路径和旧线程引用。
Apollo 日志显示 env UNKNOWN：环境值到底从哪里读取
解释 Apollo 的 env UNKNOWN 日志，列出 JVM 参数、环境变量与 server.properties 的环境配置入口和核查方法。
XXL-JOB 注册表里已经有记录，管理界面为什么看不到执行器
XXL-JOB 注册表有执行器记录但界面不显示时，分别检查逻辑执行器、AppName、地址模式与有效心跳。
博客里的代码怎么变了大小写：一次主题 CSS 的小坑
代码首字母显示异常时用计算样式定位 text-transform，区分主题 CSS 的视觉变化与数据库源文本，并限制代码区域样式。
Sentinel 规则写入 Nacos 后无法读取：一次 FlowRule 序列化排查
恢复 Sentinel 控制台向 Nacos 推送规则的旧排障，解释 FlowRuleEntity 管理字段、运行规则及序列化契约的边界。
Sentinel 限流生效，却不进入自定义 blockHandler
恢复 Sentinel URL 资源与注解资源不一致导致 blockHandler 未执行的排障，给出签名匹配的处理示例。
Nacos 注册报错：客户端版本与 Config 配置要分开查
还原两次早期 Nacos 故障：Discovery 注册错误与 Config 初始化失败，分开核对版本、客户端日志和配置地址。
FreeMarker 批量导出 Word：为什么二维码图片都变成了同一张
批量导出 Word 二维码重复时，沿路径、图片数据、模板名称和引用关系排查，并修复循环中的重复图片标识。
Linux 下载图片损坏：不能只凭双斜杠认定 FileInputStream 的问题
Windows 下载正常、Linux 图片损坏时，区分本地路径、URI、文件字节与 HTTP 响应，不把重复斜杠直接当作根因。
Nexus 3 迁移后上传 Snapshot 报 MissingBlobException
还原 Nexus 3 迁移后 Snapshot 上传失败的客户端与服务端线索，说明元数据引用和 Blob 内容的一致性及修复风险。
SolrJ 的两个过滤条件只剩一个：set 与追加参数的区别
恢复 SolrQuery 两次 set 覆盖 fq 的代码对照，改用 addFilterQuery 或一次设置多个值，并检查最终参数。
Element UI Tree 报 Expected Array, got Object：根节点的数据形状错了
Element UI Tree 要求顶层 data 为数组；通过根节点包装和 props 映射解决 Expected Array, got Object。
Vue FormData 传 List 到 Spring Boot：一次参数转换异常排查
解释 FormData 中对象列表变成 [object Object] 的原因，并给出 JSON 字符串字段与 Spring Boot 显式反序列化的完整数据契约。
Spring Boot 2 中 @JSONField 失效：一次 Web MVC 配置排查
@JSONField 不生效时先确认实际 JSON 转换器，区分 Jackson、Fastjson、WebMvcConfigurer 与 @EnableWebMvc 的作用。
Solr 执行 stop 后还能访问：配置没生效前先确认运行的是谁
恢复 Windows 上 Solr 8 停服后仍能访问的排查，提供只读端口和进程检查，先确认实例再选择正常停止方式。
程序只有一个 Main，Spring Boot 为什么开始找数据库驱动
一个只运行 main 的 Spring Boot 工程因复制 MyBatis starter 触发数据源自动配置，说明怎样按真实依赖决定删除还是配置。
Mapper XML 明明在 target 里，MyBatis 却说找不到语句
按资源打包、配置绑定、XML 加载和 statement 注册逐层排查 Invalid bound statement，并给出 Mapper 与诊断日志配置示例。
Hystrix Dashboard 能打开，hystrix.stream 却是错误页
Spring Boot 2.1.4 中 Hystrix Dashboard 可打开但指标流报错时，检查端点注册、Web 暴露、鉴权和实际指标。
Linux 进程反复被杀：从 root 邮件追到恶意 cron
回顾 Jenkins、Nexus、Tomcat 反复被杀的一次主机入侵排查，保留系统邮件与 cron 线索，区分临时恢复和系统可信性恢复。
刷新 OAuth2 Token 报 UserDetailsService is required：旧版 Spring Security OAuth 排查
为旧授权服务器提供真实 UserDetailsService Bean，并显式接入端点配置；说明限定注入、刷新用户状态与固定密码示例的风险。
刷新 Token 总是 invalid_client：Postman 里少看了客户端认证方式
还原 Postman 刷新令牌失败与 Basic Auth 成功的经过，区分客户端认证和表单参数，并检查重复认证、TLS 与公开客户端边界。
网关能访问 localhost:6666，Chrome 为什么打不开
通过网关能访问、Chrome 直连却报 ERR_UNSAFE_PORT：识别浏览器端口限制，改用合适的开发端口。
check_token 返回 401：调用者认证与被查询 Token 分开看
区分 /check/token 自定义接口和旧框架 /oauth/check_token，按调用者身份、过滤器链与目标 Token 状态定位 401。
为跨域加了 OPTIONS 匹配，OAuth2 授权反而失败了
从旧版 OAuth2 的跨域故障解释 OPTIONS 预检、过滤器链选择和链内授权的差异，给出收窄来源的 CORS 配置结构。
Python 保存文件为 0KB：先核对响应，再检查写入
用 Requests 区分空响应、错误页和写入路径问题，提供先校验响应、再以独占模式保存授权文件的示例，避免覆盖已有文件。
图片能缩放却不能左右滑：一次 PinchZoom 与 Swipe 组合排查
还原 PinchZoom.default 与 RTP.PinchZoom 两套历史入口的对照，解释缩放与轮播冲突该如何按依赖、事件和手势阶段排查。
OAuth2 客户端报 anonymous not allowed：一次 AccessTokenProvider 配错的排查
根据旧 AccessTokenProviderChain 源码解释 anonymous not allowed，核对授权类型、资源详情、Provider 与客户端上下文。
用户密码与 client secret 都报错：旧版 Spring Security 的编码配置
区分用户密码与 OAuth 客户端 secret 的校验入口，说明 DelegatingPasswordEncoder 前缀、BCrypt 存储格式及匹配关系。
旧 Spring OAuth2 缺 redirect_uri：注册配置与实际回调要一起核对
围绕未注册 redirect_uri 与回调重定向循环两次故障，检查客户端注册、请求地址、安全过滤器链和会话状态。
官方示例也构建失败：一次 Maven SNAPSHOT 依赖排查
拆开 Spring Security OAuth 旧示例中的父 POM、SNAPSHOT JAR 和仓库负缓存，说明 reactor 构建与带原始 POM 的本地安装。
提示框一闪就跳走：SUI Mobile 的 alert 需要等回调
SUI Mobile 的 $.alert 使用回调处理确认动作；把跳转紧接在弹窗调用后，会在用户确认前继续执行。
给 checkbox 写了 checked 仍不选中：先看 Angular 绑定的模型值
用布尔模型初始化 Angular checkbox，结合 ngModel 示例区分 checked 初始属性、字符串值与 AngularJS 指令。
invalid total_fee：金额单位、整数格式与浮点数
微信支付 V2 的 total_fee 使用整数分；用十进制字符串和 BigDecimal 精确转换，覆盖小数位、正数与溢出边界。
微信页面改了 JS 没生效：先确认手机实际拿到了哪个资源
微信 H5 更新后仍执行旧 JavaScript 时，结合资源 URL、响应头和构建版本排查缓存，不把退出登录当作发布方案。
网银登录报 list out of bounds，最后竟是缺了一台打印机
2018 年 Windows 10 企业网银登录报系统参数配置错误，按银行客服建议添加虚拟打印机后恢复的一次经历。
公众号 H5 的“返回”：历史回退和关闭页面不是一回事
区分公众号 H5 的历史回退、关闭 WebView 和打开指定页面，保留旧 WeixinJSBridge 调用经历及 SDK 就绪检查方向。
网站恢复后插件突然语法报错，原来 PHP 版本也变了
恢复 WordPress 后出现 unexpected T_FUNCTION 的历史案例，说明备份还需覆盖 PHP 运行版本、扩展和 Web/CLI 环境差异。
WordPress 插件翻译加载警告：报错文件并不是该修改的文件
load_plugin_textdomain 的弃用警告应追到插件调用方，第二参数使用 false，第三参数传相对插件目录的语言文件路径。
图片加载失败后的占位图：错误处理也要有终点
为普通 img 实现只尝试一次的备用图回退，并处理备用图失败、绑定时机与 AngularJS 指令的清理。
Android 模拟器报 ActivityRecord not found，重装应用后恢复
记录 ActivityRecord not found 的报错与重新安装后的恢复过程，说明排查顺序和卸载测试应用前的数据保护。
IDEA 把 import 标红，但项目能打包：一次缓存排查
IDEA import 标红而构建成功时，先对齐工程模型与依赖，再使用可控的索引恢复或缓存重建，避免删除必要本地历史。
Android 签名报密码错误，最后回到 build.gradle 查配置
区分密钥库密码、密钥密码和 alias，检查 Gradle 签名配置与环境变量，避免把密码必须相同当成修复规则。
Android Studio 旧问题：Java 特性、Gradle 同步和断点分层查
分别排查 Android Java 8 特性、Gradle 同步失败和断点不停，说明编译选项、Build Tools 与 debug 构建配置。
Ionic 一直停在启动页：一次 localhost 后端地址改动
Ionic 卡在启动页时，检查请求由谁发起、localhost 指向哪里，以及后端监听、平台安全限制和失败处理。
极光推送收不到消息：版本线索与注册状态要分开
Ionic/Cordova 极光推送收不到消息时，依次检查插件与原生版本、客户端注册、发送目标、APNs 环境和系统展示，避免盲目升降级。
Ionic 2 切回 Tab 数据不更新：页面创建与再次进入的区别
旧 Ionic 页面缓存后切回 Tab 不重新请求时，区分创建和再次进入，在合适的生命周期刷新并处理重复请求。
Cordova 构建找不到 FileUtils，原因藏在安装时的一条 warning
FileTransfer 编译找不到 FileUtils 时，怎样从安装 warning 追到被平台版本检查跳过的 file 插件。
ENOENT 与 EACCES：缺少路径和拒绝访问，先别用同一个办法修
根据错误中的 code、syscall 和 path 区分缺失路径与权限拒绝，定位 npm 安装和 Cordova 配置文件故障，避免盲目提权。
Gradle 明明配好了，Cordova 为什么还说找不到
区分 Cordova 找不到 Gradle、Wrapper 下载失败和构建执行失败，检查失败进程实际继承的环境。
npm install 失败：MSBuild 工具链与 node-sass 二进制不是一个问题
从 MSB4132 与 node-sass postinstall 两次 Windows 故障出发，检查编译工具发现、二进制下载及 Node 模块 ABI。
重定向后参数丢了：getRequestURL 与查询字符串要分开看
说明 Servlet 获取带查询参数的请求 URL，以及 Spring MVC 三种重定向写法，区分查询串、请求体与重定向响应。
前端说缺少 total_fee，后端却是订单重复：一次旧支付排障
前端提示缺少 total_fee 时，从服务端 return_code、result_code 和 prepay_id 判断统一下单是否失败，保持订单与幂等关系。
微信支付后返回页面：刷新太多会重复请求，不刷新又拿到旧状态
保留两次微信支付返回页的真实排障经历，区分重复调起支付与商品状态未更新，用重新查询状态代替盲目刷新。
TortoiseGit 右键菜单与覆盖图标：别先改错注册表
TortoiseGit 右键菜单与状态图标属于不同 Shell 扩展问题，保留旧注册表排查经历并说明检查顺序。
微信网页授权没有弹窗：一次开发者工具与手机表现不同的经历
公众号网页授权没有弹确认页，不等于未发生授权流程；区分 scope、code、openid 和两种 access_token。
微信支付 V2 签名错误：本地校验通过，仍要核对凭据上下文
V2 统一下单签名错误需同时核对参与签名的参数、商户 API Key 和实际请求上下文，本地自校验通过不等于服务端认可。
微信授权报域名不一致，最后发现 AppID 没换：两条旧调试记录
公众号网页授权遇到 10003 或 redirect_uri 域名提示时，核对实际 AppID、回调地址编码和该账号授权配置。
重读微信回调旧稿：接入校验、事件到达和接口权限分开查
结合公众号服务器接入、事件接收和 48001 排障，恢复明文 GET 签名校验示例，并区分配置 Token、接口凭证和权限。
Jenkins 构建拿不到最新 Snapshot：检查 Maven 更新策略
Maven 私服已有新 Snapshot 而 Jenkins 仍用缓存时，检查仓库更新策略、有效配置和 -U，并核对实际解析出的构件。
编辑弹窗关掉再点新增，必填提示为什么立刻变红
新增和编辑复用 Angular 弹窗时，正确重置 FormGroup、touched、dirty 与提交状态，避免初次打开就显示必填错误。
PHP 页面出现 Notice：错误报告、展示和修复不要混用
纠正 PHP 错误级别掩码中的逻辑或误用，区分 error_reporting、display_errors 与 log_errors，并通过日志验证根因是否消失。
MySQL 语法错误与保留字：先定位 SQL，再检查标识符
通过 MySQL 8.0 示例区分普通关键字与保留字，说明标识符引用、版本化词表和生成 SQL 的排查方法。
JDBC 的 SSL 警告：连接加密与服务器身份验证是两回事
MySQL JDBC 提示未验证服务器身份时，区分 TLS 加密、证书信任和主机名校验，按 Connector/J 版本选择 sslMode 而非关闭 SSL。
GitLab Webhook 报 URL is blocked：本地网络请求被安全策略拦截
GitLab Webhook 被本地网络策略拦截时，区分项目配置与管理员出站限制，并优先使用受控目标允许列表。
装 Jenkins 遇到 TLS 与 RPM 签名错误：别把验证关掉
安装 Jenkins 时遇到 curl 35、RPM 公钥缺失或签名失败，按传输握手与包真实性分层检查，保留证书和 GPG 校验。
装完 GitLab，yum 安装其他包也报错：先看失败的是哪个仓库
yum 报 GitLab source 仓库 repomd.xml 获取失败时，定位具体仓库段，区分单次禁用与地址、网络、证书等根因修复。
Eclipse 没有红叉：先查 Problems 和构建路径，别先降级错误
Eclipse 没有显示红叉时，分别检查 Problems 过滤、构建执行和 Java Build Path，不用降低错误级别掩盖依赖问题。
Jenkins 报 Unknown lifecycle phase mvn：命令与目标参数混在一起了
区分 Jenkins Maven 目标字段与 Shell 命令，处理 Unknown lifecycle phase mvn、缺少 Maven 项目入口和 Maven 安装未配置三类问题。
Eclipse 中 Maven 打 WAR 包失败：先确认实际使用的是哪套 Java
Eclipse 中打 WAR 包遇到 JRE/JDK 提示时，核对实际 Maven Java 环境，并按明确的 Spring Boot 版本配置传统部署。
MySQL localhost 能连、IP 不能连：先看传输，再看授权
MySQL 用 localhost 能连、换 IP 失败时，按传输方式、TCP 监听、网络和账号来源逐层排查，并按最小权限处理授权。
端口不通时，别把监听、防火墙和进程退出当成一回事
用 ss、进程信息和 firewalld 查询区分未监听、绑定地址不对与网络规则阻断，再选择最小范围的处理。
GitLab SMTP 发邮件失败：排查 TLS、EOFError 与 535 认证错误
从 GitLab 应用配置、TLS 模式和 SMTP 认证排查发邮件失败，区分 EOFError、535 与最终投递。
MSI 安装报 2502／2503：提权尝试不能代替安装日志
安装 TortoiseGit/TortoiseSVN 遇到 MSI 2502、2503 时，结合错误含义、管理员终端和详细日志定位，避免扩大系统目录权限。
微信小程序地图调试：真机标记与“获取位置”不是同一个问题
微信小程序地图标记不显示时检查 iconPath 和数据绑定，并区分地图中心坐标、设备定位与 callout 配置。
Android 模拟器启动失败：按 AVD、命令路径、图形和应用日志排查
区分找不到 AVD、SDK 命令路径、图形初始化、音频告警和应用崩溃，按日志逐层检查模拟器启动问题。
Oracle 字段注释顺序对不上：元数据查询也需要明确排序
关联 USER_COL_COMMENTS 与 USER_TAB_COLUMNS，以列名匹配注释、按 COLUMN_ID 排序，并区分当前用户、跨 schema 和显式投影。
写了点击事件，表单却还是提交了：一次 button 类型遗漏
表单里只执行 JavaScript 的按钮应明确 type=button；用最小 HTML 示例区分点击处理、默认提交和不同提交目标。
表单参数明明提交了，为什么只有带 BindField 的字段能收到
恢复项目自定义 BindField 与 DataBinder 字段允许列表的排查，解释空字符串、空数组及被抑制字段，避免为收参数删除保护。
SVN Cleanup 失败：写锁清理与撤销修改不是一回事
TortoiseSVN 提示前一次操作未完成时，区分清理工作副本写锁、仓库文件锁和 Revert，避免清理时误丢本地改动。
checkbox 已经取消勾选，页面上怎么还亮着
复选框取消后仍显示选中时，同时检查 checked property、初始 attribute、组件样式和 change 同步，不用外观代替表单状态。
Timestamp 格式错误：先分清日期字符串与时间戳
遇到 Timestamp format must be yyyy-mm-dd hh:mm:ss 错误时，区分 char(8) 业务日期与时间戳，并用严格解析明确 JDBC 映射边界。
请求体缺失、JSON 解析失败、媒体类型不支持：先分清是哪一层
按方法路由、缺参、请求体、JSON 转换和媒体类型定位 Spring MVC 请求错误，恢复 jQuery 与 Controller 的配套例子。
隐藏内容后表格高度变了：一条 IE8 时代的透明度笔记
区分 display:none、visibility:hidden 与 opacity:0 的布局和交互效果，并记录 IE8 时代的透明度与边框兼容写法。
对话框消息里的 br 为什么不换行：先看文本经过了几层转义
对话框中的 br 不换行时，区分 HTML 标签、实体文本和换行字符，并用纯文本渲染保留多行展示。
Eclipse 内存错误：先确认是哪一个 JVM、哪一类空间
识别 Eclipse 与应用的不同 JVM，区分 Java heap space 和旧 PermGen space，再选择正确的参数入口。
遍历时删除集合元素：ConcurrentModificationException 不只发生在多线程
用可修改 List 的示例解决遍历删除问题，说明 Iterator.remove 的调用顺序、fail-fast 限制，以及 Iterable 与迭代器模式。
Column id is ambiguous：给列限定来源，而不只是给表起别名
通过连接查询示例区分表别名、列来源限定与输出列名，说明 Column id is ambiguous 的检查位置。
getOutputStream 已调用：先明确谁负责写完这次响应
分析 Servlet Writer 与 OutputStream 冲突及 Broken pipe，给出单一响应写入者的示例，避免重复渲染和错误重试。