You need to enable JavaScript to run this app. 如何在同一路由域下配置Phoenix LiveDashboard与JSON API
优惠活动
大模型
产品
解决方案
定价
更多

如何在同一路由域下配置Phoenix LiveDashboard与JSON API

错误原因

你当前的路由配置中,live_dashboard挂载在/admin的父scope下,所以所有dashboard相关路由的完整前缀是/admin/dashboard,你直接访问/dashboard/home自然无法匹配到路由,触发Phoenix.Router.NoRouteError报错。

配置方案

1. 托管到/dashboard根路径

如果你要直接把dashboard挂在根路径的/dashboard,只需要新增一个不带模块前缀的根scope,单独挂载live_dashboard即可,和你的API路由可以共存:

defmodule ExampleApiWeb.Router do
  use ExampleApiWeb, :router
  import Phoenix.LiveDashboard.Router

  pipeline :admin do
    plug :fetch_session
    plug :protect_from_forgery
  end

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

  # 普通API路由,走api pipeline,挂载在根路径
  scope "/", ExampleApiWeb do
    pipe_through :api
    # 此处放置你的业务API路由
  end

  # LiveDashboard专属scope,走admin pipeline
  scope "/" do
    pipe_through :admin
    live_dashboard "/dashboard", metrics: ExampleApiWeb.Telemetry
  end
end

配置完成后直接访问/dashboard即可自动跳转到dashboard首页。

2. 托管到/admin/dashboard

你现有的代码本身是正确的,不需要修改,直接访问/admin/dashboard就可以正常打开,不需要请求/dashboard路径。

常见疑问解答

普通API接口和dashboard完全可以同时托管在根路径scope下,两者属于不同的scope,走不同的pipeline,路由不会互相冲突,Phoenix会自动按规则匹配对应的路由。

内容的提问来源于stack exchange,提问作者LandonSchropp

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 05:21:02