Rails 5 API遇RSpec测试失败：无路由匹配及文件不存在

看起来你在给Rails 5应用开发API时遇到了RSpec测试全挂的棘手问题，结合你提到的代码模块，我来帮你一步步拆解可能的问题点：

首先先把你涉及的核心代码片段整理出来（方便对照排查）：

1. rails routes 输出 #

Prefix Verb   URI Pattern                  Controller#Action
    post_comments GET    /posts/:post_id/comments(.:format) comments#index
                  POST   /posts/:post_id/comments(.:format) comments#create
     post_comment GET    /posts/:post_id/comments/:id(.:format) comments#show
                  PATCH  /posts/:post_id/comments/:id(.:format) comments#update
                  PUT    /posts/:post_id/comments/:id(.:format) comments#update
                  DELETE /posts/:post_id/comments/:id(.:format) comments#destroy
            posts GET    /posts(.:format)             posts#index
                  POST   /posts(.:format)             posts#create
             post GET    /posts/:id(.:format)         posts#show
                  PATCH  /posts/:id(.:format)         posts#update
                  PUT    /posts/:id(.:format)         posts#update
                  DELETE /posts/:id(.:format)         posts#destroy

2. config/routes.rb #

Rails.application.routes.draw do
  resources :posts do
    resources :comments
  end
end

3. app/controllers/application_controller.rb #

class ApplicationController < ActionController::API
  # 这里可能包含通用配置，比如异常处理、认证逻辑等
end

4. app/controllers/posts_controller.rb #

class PostsController < ApplicationController
  def index
    @posts = Post.all
    render json: @posts
  end

  def show
    @post = Post.find(params[:id])
    render json: @post
  end

  def create
    @post = Post.new(post_params)
    if @post.save
      render json: @post, status: :created
    else
      render json: @post.errors, status: :unprocessable_entity
    end
  end

  private

  def post_params
    params.require(:post).permit(:title, :body)
  end
end

5. app/controllers/comments_controller.rb #

class CommentsController < ApplicationController
  before_action :set_post

  def index
    @comments = @post.comments
    render json: @comments
  end

  def create
    @comment = @post.comments.new(comment_params)
    if @comment.save
      render json: @comment, status: :created
    else
      render json: @comment.errors, status: :unprocessable_entity
    end
  end

  private

  def set_post
    @post = Post.find(params[:post_id])
  end

  def comment_params
    params.require(:comment).permit(:content)
  end
end

6. 示例RSpec测试文件（spec/requests/posts_spec.rb） #

require 'rails_helper'

RSpec.describe "Posts", type: :request do
  describe "GET /posts" do
    it "returns all posts" do
      Post.create(title: "Test Post", body: "Test Body")
      get posts_path
      expect(response).to have_http_status(:ok)
      expect(JSON.parse(response.body).size).to eq(1)
    end
  end

  describe "POST /posts" do
    it "creates a post" do
      post posts_path, params: { post: { title: "New Post", body: "New Body" } }
      expect(response).to have_http_status(:created)
      expect(Post.last.title).to eq("New Post")
    end
  end
end

接下来，我们从几个核心方向逐一排查问题：

1. 模型关联与数据库验证 #

这是一对多关联最容易踩坑的地方：

• 检查app/models/post.rb是否正确声明关联：

  class Post < ApplicationRecord
    has_many :comments, dependent: :destroy
  end
  

• 检查app/models/comment.rb是否正确关联到Post：

  class Comment < ApplicationRecord
    belongs_to :post
  end
  

• 确认Comment的数据库迁移文件包含post_id字段并设置外键：

  class CreateComments < ActiveRecord::Migration[5.2]
    def change
      create_table :comments do |t|
        t.text :content
        t.references :post, foreign_key: true
  
        t.timestamps
      end
    end
  end
  

  如果迁移有问题，执行rails db:rollback修正后重新迁移，别忘了同步测试环境：rails db:migrate RAILS_ENV=test

2. 控制器强参数与响应格式 #

• 确认强参数是否允许了所有必要字段：比如Post的post_params要包含title和body，Comment的comment_params只需要content（post_id通过嵌套路由从URL获取，不需要手动传入）。
• 检查响应格式是否正确：ActionController::API默认支持JSON，但如果测试没设置Accept头，可能会返回错误格式。可以在测试中添加：

  get posts_path, headers: { "Accept" => "application/json" }
  

  或者在ApplicationController全局设置默认响应格式：

  before_action :set_default_response_format
  
  private
  
  def set_default_response_format
    request.format = :json
  end
  

3. RSpec测试的请求逻辑 #

• 嵌套路由的测试必须传入关联ID：比如创建Comment的测试要先创建Post，再用正确的路由辅助方法：

  describe "POST /posts/:post_id/comments" do
    it "creates a comment for a post" do
      post = Post.create(title: "Test Post", body: "Test Body")
      post post_comments_path(post), params: { comment: { content: "Great post!" } }
      expect(response).to have_http_status(:created)
      expect(post.comments.last.content).to eq("Great post!")
    end
  end
  

• 别用错路由辅助方法：比如评论列表要用post_comments_path(post)，而不是comments_path。

4. 测试环境配置与错误排查 #

• 确保spec/rails_helper.rb正确加载了API相关依赖：

  require 'spec_helper'
  ENV['RAILS_ENV'] ||= 'test'
  require File.expand_path('../config/environment', __dir__)
  require 'rspec/rails'
  require 'json' # 必须加载JSON解析库
  

• 重点看测试失败的具体错误信息：
  • 如果是ActiveRecord::RecordNotFound，大概率是测试没提前创建关联的Post；
  • 如果是ActionController::ParameterMissing，说明强参数没正确接收参数；
  • 如果是JSON::ParserError，可能是控制器返回了HTML而非JSON。
    可以在测试里加puts response.body查看实际响应内容，快速定位问题。

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