1. 为什么你的 RecordCount 总是 -1ADO 游标三件套的真实影响如果你写过 VB6、ASP 或者 VBA 里的 ADO 代码大概率遇到过这个场景SQL 明明查出来几十行数据rs.RecordCount却返回 -1rs.EOF一上来就是 True或者想MovePrevious却直接报错。很多人第一反应是 SQL 写错了其实问题往往出在Open方法那三个枚举参数上——CursorTypeEnum、CursorLocation、LockTypeEnum。这三个参数不是随便填的。它们决定了结果集是一次性快照还是实时联动决定了游标跑在服务器还是客户端也决定了你改数据时别人能不能同时改。更关键的是它们之间存在硬性约束adUseClient只支持adOpenStaticadOpenForwardOnly不支持RecordCountadLockBatchOptimistic必须配合客户端游标才能断开更新。填错一个轻则功能失效重则性能暴跌。这篇内容面向还在维护传统 VB/ASP/VBA 项目、或者用 C/C# 通过 COM 互操作调 ADO 的开发者。我会把连接串、Recordset.Open的完整参数、逐项切换后的行为对照表都列出来你可以直接复制去跑。核心检索词就三个ADO 游标类型怎么选、CursorLocation 设在哪、LockType 用哪种。搞懂这三者的组合逻辑RecordCount为 -1 这类问题基本能自己定位。先说结论RecordCount返回 -1 的根因是游标不支持向后滚动 完整行数统计。adOpenForwardOnly天生只进不退adUseServer下的某些驱动也不维护总行数。解决办法要么换成adOpenStaticadUseClient要么接受adOpenKeyset它也能返回真实行数。下面从连接串开始一步步拆。2. TaoToken 前置把模型对话和 API Key 准备好再动手在动手改 ADO 代码之前我建议先把调试环境搭顺。传统 ADO 项目最烦的是报错信息不透明——Open失败只给你一个 HRESULT具体是连接串问题、权限问题还是游标组合不合法得靠经验猜。这时候有个能快速问清楚的工具会省很多时间。TaoToken 是一个聚合多家大模型能力的平台你可以把它理解成一个统一的 API 入口同一个 Key 就能调用不同厂商的模型用来做代码解释、报错分析、SQL 审查都行。对咱们这个场景最实用的用法是把 ADO 的报错码和你的Open参数贴进去让它帮你判断是不是游标组合冲突。准备工作分两步。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后在控制台里创建一个 API Key。第二步如果你只是想快速验证某个游标组合的行为可以直接用模型对话页面 https://taotoken.net/api 把问题描述清楚比如ADO adUseClient 配 adOpenDynamic 会怎样它会给你解释降级规则。如果你打算长期在编码流程里用它比如自动审查 ADO 代码、生成测试用例那 Coding Plan 更合适地址是 https://taotoken.net/api 下的 coding-plan 入口。API Key 的管理页面在 https://taotoken.net/api 的 api-keys 路径接入文档在 doc 路径。这些链接都指向同一个 API 域名不带额外参数。需要提醒的是TaoToken 是帮你分析和生成代码的辅助工具不是数据库驱动也不是 ADO 的替代品。你的Connection对象该连 Oracle 还是连 Oracle该用OraOLEDB.Oracle.1还是MSDASQL跟它没关系。它的价值在于当你被adOpenKeyset在断开连接场景下不可用这种细节卡住时能快速得到可执行的排查方向而不是翻半天文档。我试过把一段AdoCursorsTest函数连同报错一起丢进去让它逐参数解释CursorType、LockType、CursorLocation的合法组合返回的对照表比手动查 MSDN 快不少。下面进入正题先看连接串和 Open 参数怎么写。3. 可复制配置连接串、Open 参数与三件套组合矩阵ADO 的Recordset.Open原型是这样的HRESULT Recordset15::Open( const _variant_t Source, const _variant_t ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options );五个参数里Source是 SQL 或表名ActiveConnection是已打开的连接对象或连接串后三个就是咱们要重点调的。先给一份可直接复制的连接串模板以 Oracle 为例// 连接串Provider 账号 数据源 _bstr_t connStr _T(ProviderOraOLEDB.Oracle.1;) _T(Passwordtest;) _T(Persist Security InfoTrue;) _T(User IDtest;) _T(Data SourceORCL); m_pConnection-Open(connStr, _T(test), _T(test), adConnectUnspecified);SQL Server 的话把 Provider 换成SQLOLEDB或MSOLEDBSQLData Source换成服务器名即可。连接串本身不影响游标行为但CursorLocation必须在连接建立之前或连接对象上设置这点后面会展开。接下来是核心三个枚举的取值和组合约束。先看CursorTypeEnum枚举值数值行为特征能否 RecordCountadOpenForwardOnly0只能向前资源占用最低否返回 -1adOpenKeyset1可滚动能看到他人更新看不到新增/删除是adOpenDynamic2完全动态增删改都可见视驱动而定adOpenStatic3快照打开后数据不变可前后滚动是LockTypeEnum的取值枚举值数值锁定行为适用场景adLockReadOnly1只读效率最高纯查询报表adLockPessimistic2编辑即锁他人无法访问机票预订类强一致adLockOptimistic3提交时才锁可能冲突冲突概率低的编辑adLockBatchOptimistic4批量更新支持断开离线批量改数据CursorLocationEnum只有两个有效值adUseServer 2默认服务器游标和adUseClient 3客户端游标。adUseNone 1已废弃别用。现在是最关键的组合约束写成 JSON 配置片段方便你对照{ cursor_rules: { adUseClient: { supported_cursor_types: [adOpenStatic], note: 设了 adUseClient 后其他 CursorType 会被静默降级为 adOpenStatic不报错 }, adOpenForwardOnly: { record_count: -1, move_previous: false, note: 只进游标RecordCount 恒为 -1 }, adLockBatchOptimistic: { requires: [adUseClient], note: 批量更新必须配客户端游标否则 UpdateBatch 失败 }, adOpenKeyset: { disconnected_scenario: false, note: 断开连接的脚本中不可用 } } }把这份规则记牢能避开 80% 的坑。比如你想用adOpenDynamic又要adUseClient实际拿到的是adOpenStatic因为客户端游标库只实现了静态游标。再比如adLockBatchOptimistic配adUseServerUpdateBatch会直接报错。一个完整的Open调用示例参数顺序别搞错m_pRecordset.CreateInstance(ADODB.Recordset); m_pRecordset-CursorLocation adUseClient; // 必须在 Open 之前 m_pRecordset-Open( _bstr_t(select * from test), m_pConnection.GetInterfacePtr(), adOpenStatic, // CursorType adLockReadOnly, // LockType adOptionUnspecified // Options );注意CursorLocation是在Recordset对象上设的也可以在Connection上设Recordset会继承。但一旦Recordset已经Open这个属性就变成只读改不动了。所以顺序永远是先设CursorLocation再Open。4. 验证请求逐项切换游标后的行为对照与实测结果光看表格不够得实际跑一遍才知道行为差异。下面这套验证步骤你可以直接照做准备一张有 100 行数据的测试表写一个函数接收三个枚举参数每次只改一个变量观察RecordCount、MovePrevious、UpdateBatch的表现。先看CursorType单独切换的效果CursorLocation固定adUseServerLockType固定adLockReadOnlyvoid TestCursorType(CursorTypeEnum ct) { _RecordsetPtr rs; rs.CreateInstance(ADODB.Recordset); rs-CursorLocation adUseServer; rs-Open(_bstr_t(select * from test), m_pConnection.GetInterfacePtr(), ct, adLockReadOnly, adOptionUnspecified); TRACE(CursorType%d, RecordCount%ld\n, ct, rs-RecordCount); // 尝试 MovePrevious try { rs-MovePrevious(); TRACE(MovePrevious OK\n); } catch (_com_error e) { TRACE(MovePrevious FAIL: %s\n, (LPCSTR)e.Description()); } }实测结果对照CursorTypeRecordCountMovePrevious说明adOpenForwardOnly-1报错只进游标无法后退adOpenKeyset100成功可滚动行数准确adOpenDynamic100成功依赖驱动实现adOpenStatic100成功快照行数准确再固定CursorType adOpenDynamic切换CursorLocationCursorLocation实际生效的 CursorTypeRecordCount说明adUseServeradOpenDynamic100服务器游标动态生效adUseClientadOpenStatic降级100客户端只支持静态静默降级这个降级行为特别容易踩坑你代码里写的是adOpenDynamic以为能实时看到别人改的数据结果因为设了adUseClient实际是静态快照数据永远是打开那一刻的。不报错但行为不对。最后验证LockType对更新的影响。用两个连接模拟并发连接 A 用adLockPessimistic打开并开始编辑但不提交连接 B 尝试读同一行// 连接 A悲观锁 rsA-Open(_bstr_t(select * from test where id1), connA.GetInterfacePtr(), adOpenKeyset, adLockPessimistic, adOptionUnspecified); rsA-Edit(); rsA-Fields-Item[name]-Value A修改中; // 不调用 Update保持锁定 // 连接 B尝试读同一行 rsB-Open(_bstr_t(select * from test where id1), connB.GetInterfacePtr(), adOpenKeyset, adLockReadOnly, adOptionUnspecified); // 此时 B 会阻塞或超时取决于数据库隔离级别实测下来adLockPessimistic在 A 调用Update之前会一直持有行锁B 的查询会等待。换成adLockOptimisticB 能正常读到旧值A 提交时如果 B 也改了同一行才会冲突。adLockBatchOptimistic则允许 A 断开连接后继续改最后UpdateBatch一次性提交。验证RecordCount为 -1 的修复方案最直接的就是这段m_pRecordset-CursorLocation adUseClient; m_pRecordset-Open(_bstr_t(strSQL), m_pConnection.GetInterfacePtr(), adOpenStatic, adLockReadOnly, adOptionUnspecified); // 此时 RecordCount 返回真实行数如果你不想用客户端游标比如数据量大客户端内存扛不住那就用adOpenKeyset它同样能返回真实行数但注意它在断开连接的场景下不可用。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错调试 ADO 游标时报错信息往往不直接指向游标参数而是以各种奇怪的形式出现。下面按真实报错分类排查。报错一RecordCount返回 -1但 SQL 确实有数据。这是最高频的。根因是游标不支持行数统计。排查顺序先看CursorType是不是adOpenForwardOnly是的话换成adOpenStatic或adOpenKeyset再看CursorLocation如果是adUseServer且驱动不维护行数换成adUseClient。注意adUseClient会强制adOpenStatic如果你同时写了adOpenDynamic实际生效的是静态游标。报错二MovePrevious报 Either BOF or EOF is True, or the current record has been deleted。这通常是因为游标是adOpenForwardOnly或者结果集为空。先确认CursorType不是 0再确认RecordCount 0。如果RecordCount是 -1说明游标本身不支持后退换游标类型。报错三UpdateBatch报 The provider does not support the requested method 或类似 401 权限错误。批量更新必须配adLockBatchOptimisticadUseClient。如果CursorLocation是adUseServerUpdateBatch直接失败。另外检查连接串里的账号是否有写权限只读账号会返回权限类错误。报错四local proxy failed或连接超时。这类错误跟游标无关是连接层问题。检查连接串的Data Source是否正确、网络是否通、ConnectionTimeout是否太短。在 C 里ConnectionTimeout默认 30 秒可以调大m_pConnection-ConnectionTimeout 60;报错五reading choices或字段读取返回空。这通常是CursorType和LockType组合导致字段不可读。比如adOpenForwardOnlyadLockReadOnly下某些驱动对Fields的访问有限制。换成adOpenStatic试试。另外确认Source里的 SQL 没有语法错误Open失败时Recordset状态是关闭的读字段自然为空。报错六OAuth 或认证失败。ADO 本身不走 OAuth但如果你的连接串里用了集成认证Integrated SecuritySSPI在 .NET 互操作场景下可能因为身份传递失败报认证错误。排查方向是连接串的认证方式跟游标参数无关。把User ID和Password显式写进去测试能连上就说明是认证配置问题。排查时有个通用技巧把Open的返回值 HRESULT 打出来SUCCEEDED(hr)为 false 时用_com_error取Description()比只看RecordCount有用得多。try { hr m_pRecordset-Open(...); if (FAILED(hr)) { _com_error err(hr); TRACE(Open failed: %s\n, (LPCSTR)err.Description()); } } catch (_com_error e) { TRACE(Exception: %s\n, (LPCSTR)e.Description()); }6. 语义一致 CTA把游标调试和模型辅助接起来游标三件套的调试本质是参数组合 → 行为验证 → 报错定位的循环。传统做法是翻 MSDN、试参数、看结果一轮下来半小时。用模型辅助能把这个循环压缩到几分钟把Open参数和报错贴进去让它按组合矩阵判断哪里冲突。如果你只是偶尔查一下游标组合规则用模型对话就够了地址是 https://taotoken.net/api 下的模型对话入口。如果你在维护一个老项目需要批量审查 ADO 代码、生成测试用例、解释历史遗留的游标配置那 Coding Plan 更合适入口在 https://taotoken.net/api 的 coding-plan 路径。API Key 在 https://taotoken.net/api 的 api-keys 页面管理接入文档在 doc 路径。最后给一个实用技巧把本文第 3 节那份 JSON 组合规则存成注释放在代码里下次改Open参数时先对照一遍。adUseClient只支持adOpenStatic、adOpenForwardOnly的RecordCount恒为 -1、adLockBatchOptimistic必须配客户端游标——这三条记住大部分游标问题当场就能定位。