codex 查询结果异常的根源通常在连接配置、时区设置、主从延迟或查询上下文解析中；需依次验证实际执行sql、数据库节点、时区一致性及解析链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Codex 中执行数据库查询后发现返回结果与预期不符——比如少了几条记录、字段值被截断、时间戳错位、或明明存在却查不到——问题往往不在 SQL 语句表面，而藏在连接配置、时区设置、主从同步延迟、或 Codex 自身对查询上下文的解析逻辑里。下面按真实排查路径分阶段操作，每一步都对应一个可验证的故障点。
确认 Codex 实际执行的 SQL 是否和你写的完全一致
第一步：在 Codex CLI 中启用调试日志，强制输出原始查询语句：codex --log-level debug run --file query.ts。查看控制台中 "Executing SQL" 开头的日志行，注意它是否自动加了 LIMIT、是否把参数拼成了字符串字面量、是否对日期字段做了隐式转换。
第二步：复制该日志中的完整 SQL，粘贴到数据库客户端（如 DBeaver 或 MySQL CLI）中手动执行。如果客户端结果正确而 Codex 返回错误，说明问题出在 Codex 的结果解析层；如果客户端也错，说明 Codex 已把你的意图扭曲成了另一条语句。
第三步：重点检查 Codex 是否对空值、JSON 字段、或带反斜杠的字符串做了预处理。例如你写 WHERE name = 'O\'Reilly'，Codex 日志里可能显示为 WHERE name = 'O''Reilly'——这是双单引号转义，不是 bug，但若你没在原始字符串里加转义，Codex 就擅自改写了语义。
验证数据库连接是否落在预期节点上
方法一：直接查系统变量确认当前会话节点角色：SELECT @@hostname, @@read_only;。若返回 read_only=1，说明 Codex 正在从库执行读操作——这本身正常，但若你刚插入数据就立刻查，就可能因主从延迟看到旧状态。
方法二：在查询语句末尾添加注释强制走主库：/*FORCE_MASTER*/ SELECT * FROM orders WHERE id = 123;。不同数据库驱动对这类 hint 支持程度不同，PostgreSQL 用 /*+ SET LOCAL application_name = 'master-only' */，MySQL 则依赖中间件识别。Codex 不会自动加这些 hint，必须你显式写进 SQL 字符串里。
【关键前提】 你必须清楚当前项目是否启用了读写分离中间件（如 MyCat、ShardingSphere 或应用层 DataSource 路由）。Codex 本身不参与路由决策，它只把 SQL 发给配置里指定的 JDBC URL 或 connection string 所指向的 endpoint。
检查时区与时间字段解析是否错位
第一步：运行 SELECT NOW(), @@time_zone, @@system_time_zone;，确认数据库服务器时区。若返回 +00:00 或 UTC，而你的业务按上海时间统计，那么所有 WHERE created_at > '2026-10-15' 类查询都会跨天错判。
第二步：在 Codex 的查询代码中，避免直接拼接时间字符串。改用参数化查询传递 new Date() 或 Instant.now()，让 JDBC 驱动根据连接时区自动转换。若你硬编码 "2026-10-15T00:00:00"，JDBC 可能按本地 JVM 时区解释，也可能按数据库时区解释，行为不可控。
第三步：查表结构，确认时间字段类型是 DATETIME 还是 TIMESTAMP。前者存字面值、不自动时区转换；后者存 UTC 时间戳、查出来时按 session 时区转回。Codex 若用 JS Date 对象传参，对这两种类型的行为完全不同——TIMESTAMP 字段会多一次隐式转换，极易在零点附近漏掉数据。
用 codex-devtools 回溯查询上下文链路
启动 codex-devtools 桌面应用 → 选择你的项目根目录 → 加载最近一次失败查询对应的 session ID（可在 ~/.codex/logs/ 下按时间找含 "query" 关键词的 session-*.log 文件）→ 在轨迹面板中定位到 "Database Query" 节点。
点击该节点展开，查看三项关键信息：① 实际发送的 SQL 字符串（带参数值已代入）；② 数据库返回的 raw result set 字节数与行数；③ Codex 解析后的 JavaScript 对象结构。若第②项行数正确但第③项为空，说明解析器把某列识别成了 null 或跳过了 BLOB 字段；若第②项行数就比预期少，说明问题已在数据库侧发生，无需再查 Codex 层。
这一步操作起来很简单，直接把 session-*.log 文件拖进 codex-devtools 界面就行。不需要改任何配置，也不需要重启 Codex 进程。
