Elixir Phoenix：如何在路由中匹配GET查询参数并单独处理？

嘿，这个问题问得好！在Phoenix里，默认路由是不会直接匹配查询参数的，但咱们可以用自定义路由约束来实现——让带type=coupe的请求单独走一个控制器函数，不用在原来的cars函数里堆一堆case逻辑。

1. 创建自定义路由约束模块 #

首先我们需要写一个约束模块，用来检查请求的查询参数是否符合type=coupe的条件。在你的项目里新建一个约束文件，比如lib/your_app_web/router/constraints.ex：

defmodule YourAppWeb.Router.Constraints.TypeCoupe do
  import Plug.Conn

  # 实现约束的核心匹配逻辑：检查查询参数里的type是否为"coupe"
  def match?(%Plug.Conn{query_params: %{"type" => "coupe"}}), do: true
  def match?(_conn), do: false
end

2. 修改路由配置 #

接下来在lib/your_app_web/router.ex里调整路由顺序——一定要把特定匹配的路由放在通用路由前面（因为Phoenix路由是从上到下匹配的，先匹配到的会优先处理）：

defmodule YourAppWeb.Router do
  use YourAppWeb, :router

  # 导入我们刚写的约束模块
  import YourAppWeb.Router.Constraints.TypeCoupe

  pipeline :api do
    plug :accepts, ["json"]
  end

  scope "/api", YourAppWeb do
    pipe_through :api

    # 匹配带?type=coupe的请求，指向专门的处理函数
    get "/cars", CarController, :coupe_cars, constraints: %TypeCoupe{}

    # 通用请求走原来的cars函数
    get "/cars", CarController, :cars
  end
end

3. 在控制器中添加专属处理函数 #

最后在CarController里新增coupe_cars/2函数，专门处理type=coupe的请求：

defmodule YourAppWeb.CarController do
  use YourAppWeb, :controller

  # 只处理type=coupe的请求
  def coupe_cars(conn, _params) do
    # 这里写你的专属逻辑，比如只返回轿跑车数据
    coupe_cars = YourApp.Cars.list_coupe_cars()
    json(conn, coupe_cars)
  end

  # 处理所有不带type=coupe的通用请求
  def cars(conn, params) do
    # 保留你原来的通用逻辑
    # ...
  end
end

Phoenix的路由系统默认只匹配路径、HTTP方法、主机、端口这些核心信息，查询参数不属于路由匹配的默认范畴。通过自定义约束，我们可以扩展路由的匹配规则，把特定查询参数的请求分流到单独的处理函数，让代码结构更清晰，避免在一个函数里写大量分支逻辑。

• 路由顺序是关键：特定匹配的路由必须放在通用路由前面，否则通用路由会先匹配到所有请求，特定路由永远不会生效。
• 约束可扩展性强：如果以后需要匹配其他type值（比如sedan），可以直接修改约束模块或者新建其他约束，保持路由的整洁性。

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