Python 3 处理数据库varbinary类型0x开头数据时转换异常的问题

问题根因 #

数据库驱动读取varbinary类型列时，会自动将二进制值映射为Python内置的bytes对象，对bytes直接调用str()时，Python会输出该对象的字面表示（如b'\x00\x00'），而非二进制内容对应的0x前缀十六进制文本，导致输出不符合预期。

具体调整点 #

• 修正原有空值判断的逻辑漏洞
  原代码的空值判断存在逻辑偏差：先对单元格值调用str()后再判断是否为None，本质是无效判断——str()方法的返回值永远是字符串，不可能等于None对象。这种写法还会把内容本身就是字符串"None"的正常业务数据误替换为空值。正确的判断应该直接比对原始单元格值是否为Python的None对象。
• 新增bytes类型的专属处理分支
  当检测到单元格值为bytes类型时，跳过默认的str()转换逻辑，直接调用bytes对象内置的hex()方法获取无0x前缀的十六进制串，手动拼接"0x"前缀即可得到符合预期的文本格式（如b'\x00\x00'.hex()返回"0000"，拼接后即为"0x0000"）。该分支仅匹配varbinary列返回的bytes类型，不会影响int、字符串、datetime等其他类型的正常转换。
• 保持原有管道分隔、行尾不加分隔符的写入逻辑完全不变

调整后代码 #

for row in cur.execute(sql):
    for x in range(len(row)):
        cell_val = row[x]
        # 修正空值判断：直接判断原始值是否为None
        if cell_val is None:
            cell_str = ""
        # 新增bytes类型专属处理：输出0x开头的十六进制文本
        elif isinstance(cell_val, bytes):
            cell_str = "0x" + cell_val.hex()
        # 其他类型（int、str、datetime等）按原逻辑转字符串
        else:
            cell_str = str(cell_val)
        # 原有管道分隔写入逻辑保持不变
        if len(row)-1 == x:
            f.write(cell_str)
        else:
            f.write(cell_str + "|")

补充说明 #

• 该实现完全兼容现有多类型数据的转换流程，不会对非bytes类型的输出产生任何影响
• 如果业务场景确实需要将内容为字符串"None"的单元格替换为空值，可在对应分支中新增判断即可，不会影响bytes类型和空值的处理逻辑
• 相比原代码，先将单元格值转换为最终待写入的字符串再统一执行写入操作，避免了重复调用str()带来的额外性能开销

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