案例範圍
本文不公開客戶名稱、網站內容、銷售資料或管理流程，只整理從既有框架遷移到 React 與 Vite 時遇到的通用工程問題。
遷移先處理路由責任
框架更換後，原本由伺服器處理的頁面路由改由瀏覽器接手。除了 React Router 設定，也必須在靜態託管環境加入 SPA fallback，否則使用者直接開啟深層網址會得到 404。
公開內容與管理功能分離
公開頁面需要穩定讀取內容，管理介面則需要驗證和權限。兩者共用資料來源，但不共用同一套存取假設；前端路由保護也不能取代後端資料規則。
圖片與搜尋引擎是遷移的一部分
圖片壓縮、尺寸限制、metadata、sitemap 和 canonical URL 都必須在部署前重新確認。功能能操作不代表遷移完成，公開網站還要能被正確載入、分享與索引。