You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

启动Rails Server时遇cannot load such file — sqlite3/sqlite3_native错误求助

Rails Server启动报错:cannot load such file — sqlite3/sqlite3_native

你在Windows环境下启动Rails服务器时碰到了sqlite3原生扩展加载失败的问题,具体报错片段如下:

C:\Sites\app1>rails s
Traceback (most recent call last):
22: from bin/rails:4:in `<main>'
21: from bin/rails:4:in `require'
20: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/railties-5.1.5/lib/rails/commands.rb:16:in `<top (required)>'
19: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/railties-5.1.5/lib/rails/command.rb:44:in `invoke'
18: from C:/Ruby25-x64/lib/ruby/gems/2.5....
核心报错:cannot load such file — sqlite3/sqlite3_native

我之前在Windows上折腾Rails 5.1.x的时候也踩过这个sqlite3的坑,给你几个亲测有效的解决思路:

  • 锁定兼容的sqlite3版本:Rails 5.1.5和sqlite3 1.4+版本兼容性不佳,建议在Gemfile里指定稳定版本:
    在Gemfile中修改为:gem 'sqlite3', '~> 1.3.13',然后运行bundle install

  • 重新安装sqlite3并适配Windows平台:Windows下原生扩展容易出问题,先卸载现有版本再重装:
    执行命令:

    gem uninstall sqlite3
    gem install sqlite3 --version=1.3.13 --platform=ruby
    

    如果还是不行,可以尝试指定sqlite3的安装目录(如果你单独下载了sqlite3库):

    gem install sqlite3 --version=1.3.13 -- --with-sqlite3-dir=C:/your/sqlite3/folder
    
  • 检查Ruby DevKit是否配置正确:Windows下编译Ruby原生扩展需要DevKit,确保你已经安装了对应Ruby 2.5.x的DevKit,并且运行过ruby dk.rb install完成配置

  • 验证gem安装状态:运行gem list sqlite3确认安装的版本是1.3.x系列,并且没有多个版本冲突

内容的提问来源于stack exchange,提问作者Adilkemo_fur

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.21 06:49:16