Pyodbc调用带参SQL Server存储过程未更新表数据问题排查

你遇到的无报错但数据不插入的问题，核心是两个常见的pyodbc使用错误：

1. JSON参数未序列化：你直接传入了Python原生列表对象data，pyodbc会对未知类型调用str()做隐式转换，转换后的字符串使用单引号包裹键值（格式类似[{'ImageSignatureId': '27833', 'SimilarityPercentage': '1.0'}]），不符合SQL Server对JSON格式的双引号要求。如果你的存储过程没有做ISJSON()校验和错误抛出，会直接跳过插入逻辑，也不会返回报错。你在SSMS中直接执行的语句写的是双引号JSON字面量，自然可以正常运行。
2. 传参写法冗余易触发解析bug：你代码中cursor.execute(command, (values))的写法，在部分pyodbc版本中会被识别为嵌套元组参数，导致参数绑定异常，且不会抛出明确错误。

1. 先将Python原生列表/字典序列化为标准JSON字符串再传入，使用标准库json即可：

   import json
   
   connectionString = buildConnection()
   cursor = connectionString.cursor()
   command = """exec [D7Ignite].[Service].[spInsertImgSearchHitResults] @RequestId = ?, @ImageInfo = ?"""
   # 序列化为双引号标准JSON，ensure_ascii=False避免中文被转义
   json_data = json.dumps(data, ensure_ascii=False)
   values = (requestid, json_data)
   # 去掉多余括号，直接传入元组
   cursor.execute(command, values)
   cursor.commit()
   cursor.close()
   

2. （兜底兼容）在对应存储过程的第一行添加SET NOCOUNT ON;，避免存储过程中多语句返回的行计数消息打断pyodbc的执行流，这个是pyodbc对接SQL Server存储过程的经典兼容问题。
3. （调试用）如果修复后仍异常，临时在存储过程中加入参数校验，快速定位问题：

   IF ISJSON(@ImageInfo) = 0
   BEGIN
       RAISERROR('非法JSON参数: %s', 16, 1, @ImageInfo)
       RETURN
   END
   

如果pyodbc始终存在兼容问题，可以替换为以下成熟方案：

• pymssql：专门适配SQL Server的Python驱动，对存储过程、表值参数、JSON参数的适配更友好，API写法和pyodbc几乎一致，迁移成本极低
• SQLAlchemy：封装了不同数据库驱动的底层差异，调用存储过程时可明确指定参数类型，完全避免隐式类型转换问题
• python-tds：纯Python实现的TDS协议驱动，不需要安装微软ODBC组件，参数处理逻辑透明，适合部署环境受限的场景

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