Next.js同一路徑放page與route報錯:頁面與API分開
在 app/items裡新增 route.js,打算讓同一條路徑既顯示商品頁,也回傳JSON。建置卻提示 /items/page與 /items/route指向相同路徑。這不是把函式名稱改一下就能修好的錯誤;兩個檔案正在爭用同一個URL。 App Router的 page提供頁面UI,route提供Route Handler。兩者不能放在同一個路由區段,讓同一條路徑各自處理請求。若網站需要商品頁與商品資料API,給它們各自的路徑,再讓呼叫端明確使用對應入口。 資料夾相同,就先看URL是否相同 問題結構通常長這樣。layout是共用外殼,不是這次衝突的主角;衝突來自items底下兩個具有回應責任的檔案。 app/ layout.js items/ page.js route.js page.js可以匯出頁面元件;route.js則匯出GET、POST等處理函式。即使函式寫得完全不同,這兩個檔案還是落在同一個路由區段。不要把「不同檔名」當成「不同網址」,也不要期待框架讀內容後自行猜使用者想要頁面還是JSON。 同樣地,把page改成TypeScript、route改成JavaScript不會分開路徑。副檔名決定程式語言處理,不是幫URL新增區段。衝突位置若在更深層資料夾,沿資料夾名稱算出實際路徑,會比反覆改副檔名更有用。 把API移到明確的資料路徑 一種常見結構是讓 /items保留頁面,將JSON放到 /api/items。這裡的api只是你選的路徑名稱;Route Handler並不是只能放在api資料夾,選這個名字是讓團隊容易辨認入口用途。 app/ layout.js items/ page.js api/ items/ route.js 頁面範例只顯示文字,API回合成ID,兩者不接業務資料。把這個最小結構跑通,才能再接回真正的商品清單。 // app/items/page.js export default function ItemsPage() { return <main>Items demo page</main> } // app/api/items/route.js export function GET() { return Response.json({ items: [11, 13] }) } 修改路徑後,呼叫端也要改成 /api/items,不要後端移好了,前端仍向 /items發fetch。那樣可能收到HTML頁面,再在 response.json()報解析錯誤,讓你誤以為API只是回應格式壞掉。 真建置錯誤,與修正後兩種HTTP回應 本文案例使用Next.js16.3.8與React19.3.0。先在items同時放page與route,執行 next build --webpack,建置結束碼為1,錯誤明確指出兩個頁面解析到相同路徑,並列出 /items/page與 /items/route。 之後保留page,把route移到api/items,再啟動測試專案。請求 /items回200,內容類型是HTML,畫面標記為Items demo page;請求 /api/items也回200,但內容類型是JSON,資料為 {"items":[11,13]}。這份修正比較使用實際HTTP回應,不只是檔案結構看起來不同。 curl -i http://127.0.0.1:3000/items curl -i http://127.0.0.1:3000/api/items 測試時別只看兩個狀態碼都200。確認Content-Type與內容,才能知道拿到頁面還是資料。本例在修正後以開發伺服器核兩個入口,不把它稱為完整部署驗收;自己的專案最後仍應執行適合的建置檢查,確認其他路由沒有一起出問題。...
