理解 Next.js API 路由与移动运行时限制
Next.js 的 API 路由功能允许开发者在同一个 Next.js 项目中创建后端 API 端点。这些 API 路由本质上是运行在 Node.js 环境中的服务器端代码（例如，Vercel 上的 Serverless Functions 或自定义 Node.js 服务器）。它们负责处理数据请求、数据库交互、身份验证等服务器端逻辑。
然而，Capacitor 和 Expo 的核心工作原理是将基于 Web 技术（HTML、CSS、JavaScript）构建的客户端应用打包成原生的移动应用。它们在移动设备上提供一个 WebView 环境来运行这些 Web 应用，这个环境不包含 Node.js 运行时或任何服务器端执行能力。这意味着，当一个 Next.js 应用通过 Capacitor 或 Expo 打包为移动应用时，只有客户端的 React 代码（即 pages 或 app 目录下的前端组件）会被包含进去并运行，而 pages/api 或 app/api 目录下的服务器端 API 路由代码则无法在移动设备的本地环境中执行。
因此，尝试在 Capacitor 或 Expo 打包的移动应用中直接调用 Next.js API 路由（例如，通过相对路径 /api/my-endpoint）必然会失败，因为移动应用本身没有对应的服务器来响应这些请求。
核心解决方案：后端服务解耦与独立部署
鉴于上述限制，最推荐且最稳健的解决方案是将 Next.js 应用中的 API 路由逻辑与前端代码完全解耦，并将其作为独立的后端服务进行部署。
