Rails API版本控制 #

一、版本控制策略 #

1.1 版本控制方式 #

方式 示例
URL版本 /api/v1/articles
Header版本 Accept: application/vnd.api.v1+json
参数版本 /api/articles?version=1

二、URL版本控制 #

2.1 路由配置 #

ruby
# config/routes.rb
namespace :api do
  namespace :v1 do
    resources :articles
  end
  
  namespace :v2 do
    resources :articles
  end
end

三、Header版本控制 #

3.1 约束配置 #

ruby
# config/routes.rb
scope module: :api do
  scope module: :v1, constraints: ApiConstraint.new(version: 1) do
    resources :articles
  end
end

四、总结 #

4.1 核心要点 #

要点 说明
URL版本 命名空间
Header版本 约束
废弃策略 逐步迁移

4.2 下一步 #

现在你已经掌握了API版本控制,接下来让我们学习 中间件,深入了解Rails的中间件系统!

最后更新:2026-03-28