RubyMine调试器无法连接问题求助（已排查防火墙与版本）

架构老林

2026-7-5

解决RubyMine调试器无法连接的问题

针对你遇到的调试器连接超时问题，结合你的环境配置，尝试以下方案：

调整调试连接超时时间
按照提示进入 Settings | Debugger | Ruby | Debug connection timeout，将超时时间从默认的10s调整到20s或更长，保存后重新尝试调试。
降级debug相关gem到稳定版本
你当前使用的是beta版本的debase和ruby-debug-ide，可能存在兼容性问题。执行以下命令降级到稳定版：
```
gem uninstall debase ruby-debug-ide
gem install debase -v 2.4.1
gem install ruby-debug-ide -v 0.7.3
```
安装完成后重启RubyMine，重新配置调试运行。
验证Ruby SDK配置
进入 File | Project Structure | SDKs，确认当前项目使用的Ruby SDK是3.1.4，且对应的gem列表中能看到debase和ruby-debug-ide。如果gem是安装在全局环境，确保RubyMine识别的是全局SDK；如果是rbenv/rvm管理的版本，要选中对应版本的SDK。

重置RubyMine缓存
关闭RubyMine，执行以下命令清除缓存：

rm -rf ~/Library/Caches/JetBrains/RubyMine2023.2
rm -rf ~/Library/Application\ Support/JetBrains/RubyMine2023.2/options/debugger.*

重新启动RubyMine后再尝试调试。

检查macOS隐私权限
进入系统设置的隐私与安全 | 完全磁盘访问权限，确保RubyMine已被添加并启用权限。部分情况下，Sonoma的权限限制会影响调试器的进程通信。
手动测试调试连接
在终端中进入项目目录，手动启动调试服务器：
```
rdebug-ide --port 51452 --dispatcher-port 26162 -- /Users/myUser/RubymineProjects/untitled1/main.rb
```
然后在RubyMine中创建一个Remote Debug配置，设置端口为51452，启动调试。如果能连接，说明是本地调试配置的问题；如果还是无法连接，排查端口是否被占用：
```
lsof -i :51452
```
若端口被占用，杀掉对应进程或更换调试端口。