WSL环境下Rails执行rails db:seed出现Pathname路径错误无法运行求助

核心原因 #

报错触发点是config/seed.rb中File.open(ENV['SAMPLE_IMAGES'])这行代码，WSL对Windows路径的识别规则和原生Linux、Mac不一致，路径配置、权限、环境变量加载这三个环节任意一处出错都会导致读取文件失败。

分步排查修复 #

• 第一步：修正路径格式
  WSL环境不能直接使用Windows风格的C:\xxx\xxx.jpg路径，必须转换为WSL挂载路径格式：将盘符改为小写，前置/mnt/，所有反斜杠\替换为正斜杠/，例如C:\Users\admin\Pictures\sample.jpg对应WSL路径为/mnt/c/Users/admin/Pictures/sample.jpg。
  先在WSL终端执行以下命令验证路径有效性，能正常输出文件信息说明路径正确：

  ls /mnt/c/替换为你的实际图片路径
  

• 第二步：修正.env配置
  将.env中SAMPLE_IMAGES的值改为上一步验证通过的WSL路径，如果路径包含空格，需要用单引号包裹整段路径，示例：

  SAMPLE_IMAGES='/mnt/c/Users/My Name/project/sample.jpg'
  

  可以在seed.rb开头临时加一行打印代码验证环境变量是否正确加载：

  puts "读取到的图片路径：#{ENV['SAMPLE_IMAGES']}"
  

  执行rails db:seed时如果输出的路径和你配置的一致，说明环境变量加载正常。
• 第三步：修复文件权限
  WSL访问Windows盘符下的文件可能存在权限不足问题，执行以下命令给目标文件赋读权限：

  sudo chmod +r /mnt/c/替换为你的实际图片路径
  

• 第四步：清理Rails缓存进程
  如果修改配置后还是报错，大概率是Rails的spring预加载进程缓存了旧的环境变量，执行以下命令关闭后再重新跑seed即可：

  bin/spring stop
  rails db:seed
  

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