Windows10环境下Rails连接Oracle报No DLL is found to hook错误

1. 组件架构不匹配：Oracle Instant Client、Ruby、ruby-oci8三者的架构（32位/64位）不一致，64位的Ruby无法加载32位的oci.dll文件。
2. 环境变量配置错误：Oracle Instant Client的路径未加入系统PATH，或PATH中其他目录存在版本不兼容的oci.dll优先被加载，同时缺少ORACLE_HOME、TNS_ADMIN必要环境变量。
3. 系统依赖缺失：缺少Oracle Instant Client运行所需的VC++可再发行组件包，导致oci.dll无法被系统正常加载。
4. 配置文件格式错误：database.yml中development节点缩进不符合YAML语法规范，导致数据库连接配置未被正确读取。

• 架构一致性校验：确认Oracle Instant Client为x64版本，和已安装的x64 Ruby、x64 ruby-oci8 2.2.9架构完全匹配，禁止混用32位和64位组件。
• 修复环境变量配置：
  1. 把Oracle Instant Client的根目录（包含oci.dll的目录）添加到系统级PATH的最靠前位置，避免其他路径下的同名dll覆盖
  2. 新增系统环境变量ORACLE_HOME，值为Oracle Instant Client的根目录
  3. 新增系统环境变量TNS_ADMIN，值和ORACLE_HOME保持一致
  4. 配置完成后重启所有命令行终端、IDE甚至系统，确保环境变量全局生效
• 安装必要依赖组件：安装Microsoft Visual C++ 2015-2019 Redistributable (x64) 运行库，安装完成后重启系统。
• 校验ruby-oci8加载状态：打开命令行执行ruby -r oci8 -e "puts OCI8::VERSION"，如果能正常输出版本号2.2.9，说明dll加载正常，否则继续排查前三个步骤。
• 修复database.yml配置错误：YAML要求同级节点缩进一致，修正后配置如下：

default: &default
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  timeout: 5000

development:
  <<: *default
  adapter: oracle_enhanced
  database: SID
  username: USER
  password: PASSWORD
  host: IP
  port: PORT

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