ODBC链接表插入失败（错误3155）技术求助

问题描述 #

前端使用MS-Access，通过ODBC连接服务器端数据库，主表单关联父链接表tblInvoices，子表单关联子链接表tblInvoiceDetails（通过外键关联父表唯一键），表单嵌套Tab控件。操作时出现以下异常：

• 添加新记录时点击表单，弹出错误：ODBC - insert on a linked table failed. (Error 3155)
• 点击关闭按钮时也会触发该错误
• 主表单输入数据后回车切换到子表单，弹出ODBC - insert on a linked table "tblInvoices" failed提示
• 数据表规模：tblInvoices约100万条，tblInvoiceDetails约200万条

已尝试操作：

• 用少量数据重建两张表并关联，问题依旧
• 确认两张表均已设置主键

排查与解决方案 #

1. 校验ODBC驱动兼容性

• 确保使用对应服务器数据库的最新稳定版ODBC驱动（如SQL Server对应ODBC Driver 17/18），避免版本过旧引发兼容问题
• 匹配Access与ODBC驱动的位数：32位Access必须用32位ODBC数据源，64位则用64位，位数不匹配会导致写入失败

2. 调整主表单记录保存逻辑

Access默认切换记录时自动保存主表新记录，远程ODBC连接易因延迟或锁机制失败，可手动控制保存时机：

• 在主表单的BeforeUpdate事件中添加代码，手动保存并捕获错误：

  Private Sub Form_BeforeUpdate(Cancel As Integer)
      On Error GoTo Err_Handler
      Me.Dirty = False ' 手动触发主表单记录保存
      Exit Sub
  Err_Handler:
      MsgBox "保存主记录失败：" & Err.Description, vbCritical
      Cancel = True
  End Sub
  

• 若为Access 2010+版本，关闭表单AutoSave属性，改为点击手动保存按钮后再切换到子表单

3. 检查服务器端表约束与锁机制

• 确认tblInvoices的主键在服务器端是自增/标识列，且Access链接表时正确识别该属性（链接表设计视图中，主键字段的"新值"属性应为"递增"）
• 直接在服务器端执行插入语句测试，排查是否存在触发器、非空约束、字段长度限制等问题：

  INSERT INTO tblInvoices (字段1, 字段2) VALUES ('测试值1', '测试值2');
  

• 调整服务器端锁超时设置，大表操作易因锁等待超时导致插入失败

4. 优化链接表性能与配置

• 重新链接表：删除现有链接，通过ODBC重新关联，确保链接时正确识别主键与索引
• 为tblInvoices的主键、tblInvoiceDetails的外键添加索引，减少写入时的资源消耗
• 限制主表单加载的数据量：将表单RecordSource设为仅加载空记录的查询（开启数据输入模式），避免加载100万条历史数据：

  SELECT * FROM tblInvoices WHERE 1=0;
  

5. 校验表单关联设置

• 确认主表单与子表单的链接字段完全匹配：主表单链接字段为tblInvoices主键，子表单链接字段为tblInvoiceDetails外键，字段类型、长度一致
• 检查Tab控件的切换事件，排除因触发不必要的记录操作导致的插入失败

内容的提问来源于stack exchange，提问作者MKaranjawala