Python使用pymssql+pandas读SQL Server时列存在却报Invalid Column Name错误

核心报错原因 #

该问题本质是pymssql驱动的元数据预校验机制与SQL Server批处理执行逻辑不匹配导致的，具体触发逻辑如下：

• pymssql底层依赖的DB-Library接口在执行多语句批处理时，会默认开启FMTONLY模式提前解析最终结果集的元数据，用于后续pandas构造DataFrame。该模式下只会做语法和元数据校验，不会实际执行语句，因此你前面创建#Archives临时表的逻辑不会生效，解析到UNION ALL段引用#Archives.RecID时自然会报列不存在的错误。
• SSMS执行查询时不会提前开启全量预校验，会按顺序逐段执行语句，执行到UNION ALL部分时#Archives已经创建完成，因此不会触发报错。
• 你将#Archives的创建逻辑改为子查询直接嵌入UNION ALL后，整个查询的元数据可以一次性绑定，不需要依赖临时表的预创建信息，因此问题消失。

可选解决方案 #

除了你已经使用的子查询嵌入方案外，还可以通过以下方法解决：

• 在查询开头添加SET FMTONLY OFF语句，关闭驱动的预校验模式，强制SQL Server实际执行语句后再返回元数据。
• 将临时表创建和最终查询拆分为两次独立调用：先执行所有临时表创建逻辑，再单独执行SELECT * FROM #Union获取结果，此时所有临时表已创建完成，不会触发元数据校验错误。
• 使用普通CTE代替临时表存储中间结果，整个查询作为单段逻辑执行，元数据可以一次性完成绑定。

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