Phoenix LiveView事件路由异常：详情页事件触发列表页未定义函数错误

未更新依赖的情况下，在category_show、brand_show等详情页点击「add_to_cart」按钮时，本该触发详情页LiveView的handle_event/3方法，却错误将事件发送到对应列表页（如CategoryLive.Index）的LiveView，引发UndefinedFunctionError（列表页未定义该事件处理函数）。即便添加商品到购物车的逻辑执行成功（能看到提示且商品已加入购物车），页面仍会跳转到列表页。临时在列表页添加空的handle_event/3方法后，详情页功能恢复正常，但该问题在多个页面重复出现，怀疑与近期新增的socket/channel用户追踪功能有关。

相关代码 #

category_index.ex #

@impl true
def mount(_params, %{"user_token" => user_token}, socket) do
  user = Accounts.get_user_by_session_token(user_token)

  {:ok,
    socket
    |> assign(:current_user, user)
    |> assign(:categories, Catalog.list_categories())}
end

def mount(_params, _session, socket) do
  {:ok, assign(socket, :categories, Catalog.list_categories())}
end

@impl true
def handle_params(params, _url, socket) do
  {:noreply, apply_action(socket, socket.assigns.live_action, params)}
end

defp apply_action(socket, :show, %{"id" => id}) do
  socket
    |> assign(:page_title, "Show Category")
    |> assign(:category, Catalog.get_category!(id))
    |> assign(:products, Catalog.get_available_products_by_category_id(id))
end

defp apply_action(socket, :index, _params) do
  socket
  |> assign(:page_title, "Listing Categories")
  |> assign(:category, nil)
end

category_show.ex #

@impl true

def mount(_params, %{"user_token" => user_token}, socket) do
  user = Accounts.get_user_by_session_token(user_token)

  {:ok,
    socket
    |> assign(:current_user, user)
    |> assign(:cart, ShoppingCart.get_cart_by_user_id(user.id))
    |> assign(:cart_items, %CartItem{})}
end

def mount(_params, _session, socket) do
  {:ok, socket}
end

@impl true
def handle_event("add_to_cart", %{"product" => product_id, "quantity" => quantity}, socket) do
  IO.inspect(product_id)
  IO.inspect(quantity)
  case socket.assigns[:current_user] do
    %Eshopy.Accounts.User{role: :user} ->
      create_and_add_item(product_id, quantity, socket)

    _ ->
    {:noreply,
      socket
      |> put_flash(:info, "You must be logged in")}
  end
end

@impl true
def handle_params(%{"id" => id}, _, socket) do
  {:noreply,
    socket
    |> assign(:page_title, "Show Category")
    |> assign(:category, Catalog.get_category!(id))
    |> assign(:products, Catalog.get_available_products_by_category_id(id))}
end

defp create_and_add_item(product_id, quantity, socket) do
  product = Catalog.get_product!(product_id)
  quantity = String.to_integer(quantity)

  socket =
    case ShoppingCart.get_cart_by_user_id(socket.assigns.current_user.id) do
      %Cart{} = cart ->
        add_item_to_shopping_cart(socket, cart, product, quantity)

      nil ->
        {:ok, %Cart{} = cart} = ShoppingCart.create_cart(socket.assigns.current_user)
        add_item_to_shopping_cart(socket, cart, product, quantity)
    end

  {:noreply, socket}
end

defp add_item_to_shopping_cart(socket, cart, product, quantity) do
  case ShoppingCart.add_item_to_cart(cart, product, quantity) do
        {:ok, _item} ->
          socket
          |> put_flash(:info, "Item added to shopping cart")

        {:error, _changeset} ->
          socket
          |> put_flash(:info, "Error with adding item")
  end
end

核心错误日志 #

[error] GenServer #PID<0.684.0> terminating
** (UndefinedFunctionError) function EshopyWeb.CategoryLive.Index.handle_event/3 is undefined or private
    (eshopy 0.1.0) EshopyWeb.CategoryLive.Index.handle_event("add_to_cart", %{"product" => "5", "quantity" => "1", "value" => ""}, #Phoenix.LiveView.Socket<...>)

排查与解决思路 #

1. 拆分LiveView模块与路由 #

从代码可见，category_index.ex中同时处理了:index和:show两种路由动作，而你又单独创建了category_show.ex模块，这会导致路由绑定冲突——详情页的请求可能仍被路由到Index模块的实例，事件自然会发送到错误的LiveView。

• 移除category_index.ex中apply_action/3里处理:show动作的代码。
• 调整路由配置，将详情页路由明确绑定到CategoryLive.Show模块，确保列表与详情页使用独立的LiveView实例。

2. 验证模板事件绑定目标 #

检查详情页模板中「add_to_cart」按钮的phx-target属性：

• 如果未指定phx-target，事件可能默认绑定到父级列表页的LiveView实例。需明确设置phx-target={@myself}，确保事件发送到当前详情页的LiveView。
• 确认表单/按钮的phx-submit="add_to_cart"未继承父页面的LiveView上下文。

3. 排查Socket用户追踪逻辑 #

新增的用户追踪功能若修改了全局Socket钩子或会话传递逻辑，可能导致LiveView实例的上下文混淆：

• 检查是否在Socket钩子中错误复用了LiveView PID，或修改了user_token的传递方式，导致详情页LiveView与列表页共享错误的会话数据。
• 确认用户追踪的Channel订阅逻辑未干扰LiveView的Socket分配。

4. 修复临时方案的遗留问题 #

临时添加空handle_event/3只是规避错误，需彻底解决事件发送目标错误的问题：

• 确保每个页面的LiveView实例独立，路由与模块一一对应。
• 清理模板中模糊的事件绑定，明确指定目标实例。

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