Ruby经ODBC连接Snowflake报ArgumentError: string contains null byte

该报错由三层问题叠加导致：

1. M1芯片下Rosetta 2转译x86_64二进制时，UTF-16宽字符转UTF-8的过程会生成多余的尾部空字节\0
2. 旧版本ruby-odbc gem直接把C层ODBC接口返回的带空字节的字符数组透传给Ruby层，Ruby原生字符串不允许内嵌空字节，直接触发参数错误
3. 环境里同时存在iODBC、unixODBC两个驱动管理器，编译ruby-odbc时链接到和isql命令不一致的驱动管理器，导致配置不匹配

• 第一步：统一所有组件的运行架构，彻底避免混合架构转译异常
  1. 右键点击终端应用，选择「显示简介」，勾选「使用Rosetta打开」，重启终端后执行arch，确认返回值为i386
  2. 卸载arm架构Homebrew安装的odbc相关组件，用x86_64模式的Homebrew重装依赖：

     arch -x86_64 /usr/local/bin/brew uninstall --ignore-dependencies unixodbc freetds
     arch -x86_64 /usr/local/bin/brew install unixodbc freetds
     

  3. 卸载之前手动安装的iODBC-SDK，避免和unixODBC冲突：直接删除/Library/Frameworks/iODBC.framework、/Library/Frameworks/iodbcinst.framework两个目录即可
     注意：所有和ODBC、Ruby相关的二进制组件必须全部为x86_64架构，任意一个组件混了arm64架构都会触发转译异常
• 第二步：重新编译安装ODBC相关Ruby gem，确保链接到正确的依赖
  1. 卸载原有问题gem：

     gem uninstall -aIx dbi dbd-odbc ruby-odbc sequel
     

  2. 安装ruby-odbc时指定编译参数，强制链接到x86_64版本的unixodbc：

     gem install ruby-odbc -- --with-odbc-dir=/usr/local/opt/unixodbc --with-odbc-lib=/usr/local/opt/unixodbc/lib
     

  3. 验证gem架构合规：执行lipo -info $(gem contents ruby-odbc | grep odbc.bundle)，确认输出仅包含x86_64架构，无arm64标识
  4. 安装5.49及以上版本的Sequel，该版本起ODBC适配器内置了空字节自动清洗逻辑：

     gem install sequel
     

• 第三步：调整ODBC驱动配置，从源头规避空字节生成
  1. 在shell配置文件（~/.zshrc/~/.bashrc，根据你用的shell选择）末尾添加环境变量，强制ODBC组件读取正确的配置文件、使用unixODBC作为驱动管理器：

     export ODBCINI=~/.odbc.ini
     export ODBCSYSINI=~
     export SIMBA_DRIVER_MANAGER=UNIXODBC
     

     执行source ~/.zshrc重载配置生效
  2. 编辑~/.odbc.ini中对应Snowflake的数据源段，添加一行配置强制驱动返回UTF-8编码结果，不使用UTF-16宽字符：

     [Snowflake]
     Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
     # 新增下面这行
     DriverUnicodeType=1
     

执行以下最小测试脚本，能正常返回Snowflake版本信息即为修复完成：

require "sequel"
DB = Sequel.odbc("Snowflake", user: "你的用户名", password: "你的密码")
puts DB.fetch("SELECT CURRENT_VERSION() AS ver").first[:ver]

如果使用DBI方式连接，同样可以正常连通，不会再抛出空字节相关错误。

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