我来的解决方案是使用rswiggem和rspec-rails-swagger gem-通过在您的Gemfile中添加以下内容来安装rswiggem：

#Gemfile
gem 'rswag-api'
gem 'rswag-ui'

group :development, :test do
  gem 'rspec-rails',         '~> 3.8.1'
  gem 'rspec-rails-swagger', '~> 0.1.5'
...
end

• 运行“捆绑安装”
• 运行rails g rwag： install生成swagger_helper.rb
• 要使用rspec-rails-swagger创建新的请求规范，请运行rails生成rspec： swagger PostsController（将名称调整为您想要编写规范的won控制器）。
• 编写一些规范，如rspec-rails-swagger README
中所述
• 运行bundle exec rake swagger生成一个swagger. json文件。
• 挂载RSwagAPI和RSwagUI引擎，方法是将以下行添加到您的routes. rb文件中：

#../config/routes.rb

Rails.application.routes.draw do
  mount Rswag::Ui::Engine => '/api-docs'
  mount Rswag::Api::Engine => '/api-docs'
...#other routes come here
end

• 使用rails s
启动您的rails服务器
• 导航到localhost:3000/api-docs查看生成的Swagger留档。

注意：它工作得很好，并回复了客户的要求，即：

• 生成Swagger 2.0兼容的留档
• 能够直接从Swagger接口执行请求以查看真实数据

我删除了rswag-spesgem，因为它无法验证我在RailsAPI应用程序中使用的gem以JSONAPI格式返回active_model_serializers响应模式。我总是：

• 生成文档
• 注释掉失败的测试
• 然后取消注释失败的测试，以防我需要生成一些新的留档，这真的很难维护。

现在请求规范由RSpec和rspec-rails-swagger同时验证，没有任何麻烦。

希望这有帮助。

我们的工作解决方案是使用：

• swagger-阻止宝石以生成SwaggerJSON
• SwaggerUI控制台Chrome扩展提供SwaggerUI