在使用 QuickBooks Online (QBO) PHP SDK 执行时间范围查询时，若将 MySQL 中读取的日期变量（如 '2022-01-01'）直接拼入 Query 字符串，易因引号缺失导致语法错误、查询无结果；正确做法是确保日期值被单引号包裹并安全嵌入 SQL-like 查询字符串。
在使用 quickbooks online (qbo) php sdk 执行时间范围查询时，若将 mysql 中读取的日期变量（如 `'2022-01-01'`）直接拼入 query 字符串，易因引号缺失导致语法错误、查询无结果；正确做法是确保日期值被单引号包裹并安全嵌入 sql-like 查询字符串。
QuickBooks Online 的 Query() 方法虽采用类 SQL 语法（如 SELECT * FROM Invoice WHERE MetaData.LastUpdatedTime > '2022-01-01'），但它并非原生 SQL 引擎，而是由 QBO 后端解析的查询 DSL。因此，日期、字符串等字面量必须显式加上单引号，否则服务端会将其视为未定义标识符或类型不匹配，最终返回空结果集——这正是问题中 $qboLastUpdate 变量未加引号时“查不到数据”的根本原因。
✅ 正确写法：手动补全单引号
$qboTableExtract = $dataService->Query(
"SELECT * FROM $qboTable " .
"WHERE MetaData.LastUpdatedTime > '" . $qboLastUpdate . "' " .
"STARTPOSITION $i MAXRESULTS $end"
);? 关键点：'" . $qboLastUpdate . "' —— 外层双引号字符串中，用连接符 . 将单引号 ' 显式拼接到变量两侧，确保最终发送给 QBO 的查询为：
... WHERE MetaData.LastUpdatedTime > '2022-01-01' ...
⚠️ 常见误区与规避建议
❌ 错误示例：
"WHERE MetaData.LastUpdatedTime > $qboLastUpdate" → 实际发送 > 2022-01-01（无引号，非法）
"WHERE MetaData.LastUpdatedTime > '$qboLastUpdate'" → 若 $qboLastUpdate 本身不含引号（如 2022-01-01），结果仍是 > '2022-01-01' ✅；但若数据库字段类型为 DATE 且 PHP 读取后未格式化（如变成对象或时间戳），则可能出错。推荐统一显式拼接，避免依赖变量原始形态。-
✅ 安全增强（推荐）：对日期变量做标准化校验与转义
// 确保 $qboLastUpdate 是标准 'YYYY-MM-DD' 格式字符串 $qboLastUpdate = date('Y-m-d', strtotime($qboLastUpdate)); // 或从 PDO 获取时强制格式化 $stmt = $pdo->prepare("SELECT DATE_FORMAT(last_run, '%Y-%m-%d') as last_run FROM sync_log WHERE table_name = ?"); $stmt->execute([$qboTable]); $qboLastUpdate = $stmt->fetchColumn(); -
? 进阶提示：QBO 的 LastUpdatedTime 是 ISO 8601 时间戳（含时分秒，如 '2022-01-01T08:30:45-08:00'）。若需更高精度增量同步，建议存储并比对完整时间戳（DATETIME 类型 + date('c') 格式），而非仅日期：
// 存储示例（MySQL DATETIME） $lastSyncTime = '2022-01-01T08:30:45-08:00'; // 查询时保持格式一致 "WHERE MetaData.LastUpdatedTime > '$lastSyncTime'"
✅ 总结
QBO Query 字符串中的日期/字符串字面量必须被单引号包裹，且该引号需作为字符串常量显式写出，不能依赖变量自身是否含引号。始终使用 '" . $var . "' 模式拼接，并配合 date() 或数据库 DATE_FORMAT() 确保格式合规。此举不仅解决当前问题，更是构建健壮、可维护的 QBO 同步逻辑的基础规范。
