Grape API参数块中requires指令未生效，如何启用校验？

我编写了一个继承自Grape::API的Customers API类，但标记为requires的参数并未被校验。当请求未携带这些参数时，代码仍会继续执行而不抛出异常，请问该如何启用requires参数的校验？

module API
  module V1
    # API interface for users
    class Customers < Grape::API
      include API::V1::Defaults

      helpers do
        def customer_options(params)
          {
            user_id: params.user_id,
            phone: params.phone,
            date_of_birth: params.date_of_birth
          }
        end
      end

      resource :customers do
        desc "Create a customer"
        post do
          params do
            requires :user_id, type: Integer, desc: "ID of associated user record", allow_blank: false
            requires :phone, type: String, desc: "Applicant's phone number", allow_blank: false
            requires :date_of_birth, type: String, desc: "Applicant's date of birth", allow_blank: false
          end

          options = customer_options(permitted_params)

          customer = nil
          Customer.transaction do
            customer = Customer.create!(options)
          end
          result = {
            id: customer.id,
            phone: customer.phone,
            user_id: customer.user_id
          }
          result["date_of_birth"] = customer.date_of_birth if
            customer.date_of_birth.present?
          result
        end
      end
    end
  end
end

可能的原因及解决步骤 #

1. 手动触发参数校验

Grape默认会自动校验params块中定义的requires参数，但如果自动校验未触发，可以在使用参数前手动调用validate!方法强制执行校验：

post do
  params do
    requires :user_id, type: Integer, desc: "ID of associated user record", allow_blank: false
    requires :phone, type: String, desc: "Applicant's phone number", allow_blank: false
    requires :date_of_birth, type: String, desc: "Applicant's date of birth", allow_blank: false
  end

  validate! # 添加这行手动触发校验

  options = customer_options(permitted_params)
  # 后续代码...
end

调用validate!后，若请求缺少必填参数或参数不符合规则，Grape会抛出Grape::Exceptions::ValidationErrors异常，阻止代码继续执行。

2. 检查API::V1::Defaults模块配置

问题可能出在你引入的API::V1::Defaults模块中，需确保该模块没有禁用参数校验：

• 确认模块中没有设置disable_validation: true
• 确保模块正确继承/包含Grape的核心功能，比如include Grape::API::Helpers
• 检查是否设置了正确的请求格式，比如format :json（Grape的参数校验依赖请求格式解析）

3. 使用declared方法获取参数

替代permitted_params，使用Grape提供的declared方法获取参数，该方法会自动触发参数校验：

options = customer_options(declared(params, include_missing: false))

declared方法会返回严格符合params块定义的参数集合，同时自动校验必填项是否存在。

4. 检查Grape版本

旧版本的Grape可能存在参数校验的bug，建议升级到稳定版本（比如>=1.5.0），确保参数校验逻辑正常工作。

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