运行rake native gem时触发NoMethodError：nil:NilClass无split方法

Hey there, let's work through this sqlite3 gem problem together— I’ve dealt with similar frustrating errors when setting up Rails apps, so here’s what’s likely going wrong and how to fix it:

First: Address the Missing sqlite3_native Error #

The core issue here is that the sqlite3 gem’s native extension didn’t compile properly during bundle install. This usually happens because your system lacks the necessary development libraries for sqlite3, or the gem couldn’t locate them correctly.

Step 1: Install System-Level sqlite3 Dependencies #

• Ubuntu/Debian: Run this to install the required development libraries:

  sudo apt-get update && sudo apt-get install libsqlite3-dev
  

• macOS (with Homebrew): Install or update sqlite3 on your system:

  brew install sqlite3
  

• Windows: Ensure you have the RubyInstaller DevKit installed (it handles native gem compilation), and download pre-built sqlite3 binaries if your system doesn’t have them already.

Step 2: Recompile the sqlite3 Gem Properly #

Instead of relying on bundle install alone, explicitly guide the gem to your system’s sqlite3 libraries:

1. First, remove the broken existing sqlite3 gem:

   gem uninstall sqlite3
   

2. Configure bundle to build the gem with the correct paths, then reinstall:
   • For macOS (if you installed sqlite3 via Homebrew):

     bundle config build.sqlite3 --with-sqlite3-dir=/usr/local/opt/sqlite3
     bundle install
     

   • For Linux/Windows: Omit the path flag if sqlite3 is in a standard system location, or replace the path with your actual sqlite3 directory.

Step 3: Use Bundle Exec to Ensure Correct Gem Loading #

Sometimes rails server pulls in a system-wide gem instead of the one installed via your project’s bundle. Run this command instead to use the correct gem:

bundle exec rails server

Fixing the NoMethodError from rake native gem #

That error pops up because rake native gem is an outdated command— it’s no longer the right way to build native gems. The steps above already handle compiling the native extension properly, so you can skip this rake command entirely.

Bonus: Check Ruby & sqlite3 Gem Compatibility #

If the above steps don’t resolve the issue, double-check that your Ruby version is compatible with the sqlite3 gem version in your Gemfile. For example, newer sqlite3 versions (like 1.5+) require Ruby 2.5 or higher. If you’re on an older Ruby, lock the gem to a compatible version:

1. Edit your Gemfile to use a stable, compatible version:

   gem 'sqlite3', '~> 1.4.2'
   

2. Run bundle install again to install the specified version.

内容的提问来源于stack exchange，提问作者Random Channel