Shopify Remix应用bundle install报错：wdm原生扩展构建失败求助

安全阿岳

2026-6-23

解决wdm 0.1.1 gem原生扩展构建失败（rb_thread_call_without_gvl隐式声明）的方案

wdm 0.1.1是非常老旧的gem版本，适配的是Ruby 2.x及更早版本。Ruby 3.x对内部C API做了调整，rb_thread_call_without_gvl的声明方式变化，导致编译原生扩展时触发隐式声明错误。

锁定wdm到兼容版本（推荐）
打开项目根目录的Gemfile，找到gem 'wdm'行，修改为：
```
gem 'wdm', '>= 0.2.1'
```
然后执行：
```
bundle update wdm
shopify app dev
```
0.2.1及以上版本已经修复了Ruby 3.x的兼容性问题。
手动安装兼容版wdm
先卸载已安装的旧版本：
```
gem uninstall wdm
```
直接安装兼容版本：
```
gem install wdm -v 0.2.1
```
再执行bundle install，bundle会自动使用已安装的兼容版本。
确保Devkit编译环境配置正确
打开RubyInstaller自带的MSYS2终端（或者在普通CMD里执行ridk enable激活Devkit），运行：
```
ridk install
```
选择安装全部组件（msys2、工具链等），完成后重新执行bundle install。
临时绕过编译错误（应急方案）
如果暂时无法升级wdm，可通过编译参数忽略隐式声明错误：
```
bundle install --with-cflags="-Wno-error=implicit-function-declaration"
```
这个参数会让编译器跳过该错误，强制完成扩展构建，但不推荐长期使用，还是建议升级wdm版本。