Cloudflare Pages 部署 Next.js 应用教程

Cloudflare Pages 部署 Next.js 应用教程

本教程将指导你如何将现有的 Next.js 应用部署到 Cloudflare Pages。

准备工作

  1. 安装部署依赖

    首先,安装 @cloudflare/next-on-pages:

    bash 复制代码
    npm install --save-dev @cloudflare/next-on-pages
  2. 添加 wrangler.toml 配置文件

    在项目根目录创建 wrangler.toml 文件,内容如下:

    toml 复制代码
    name = "my-app"
    compatibility_date = "2024-07-29"
    compatibility_flags = ["nodejs_compat"]
    pages_build_output_dir = ".vercel/output/static"
    
    [env.production.vars]
    NEXTAUTH_URL = "https://your-domain.com"
    NEXTAUTH_SECRET = "your-secret-key"
    # 添加其他环境变量,记得给值加上双引号
  3. 更新 next.config.mjs

    修改 next.config.mjs 文件:

    javascript 复制代码
    import { setupDevPlatform } from '@cloudflare/next-on-pages/next-dev';
    
    /** @type {import('next').NextConfig} */
    const nextConfig = {};
    
    if (process.env.NODE_ENV === 'development') {
      await setupDevPlatform();
    }
    
    export default nextConfig;

    注意:通过 Git 部署时,需要注释掉 setupDevPlatform() 相关代码,也就是可以不添加这部分代码。

  4. 配置 Edge Runtime

    为所有服务端渲染的路由(包括 API 路由)添加以下配置:

    javascript 复制代码
    export const runtime = "edge";
  5. 更新 package.json

    在 scripts 中添加:

    json 复制代码
    "scripts": {
      "pages:build": "npx @cloudflare/next-on-pages",
      "preview": "npm run pages:build && wrangler pages dev",
      "deploy": "npm run pages:build && wrangler pages deploy"
    }

部署步骤

  1. 创建 Cloudflare Pages 项目

  2. 连接 GitHub 仓库

  3. 配置构建设置

    • 选择 Next.js 框架预设
  4. 设置环境变量(可选)

部署方式

  • 命令行部署: npm run deploy
  • Git 集成: 推送代码到生产分支自动触发部署

常见问题及解决方案

  1. 编译问题:确保本地 npm run build 能通过

  2. 启用 nodejs_compat 兼容性标志
    !\[Pasted image 20240913115015.png]

  3. 环境变量问题:将配置放入 wrangler.toml
    否则 util.ts 的相关读取不到配置。

  4. 路由配置:所有非静态路由都需设置 Edge Runtime

  5. 第三方 API 兼容性:某些 API 可能不兼容 Edge Runtime,需要进行适配或替换

  6. 必须检查所有的是否缺少,否则都会最终失败。

    Please make sure that all your non-static routes export the following edge runtime route segment config:
    export const runtime = 'edge';

通过以上步骤和注意事项,你应该能够成功将 Next.js 应用部署到 Cloudflare Pages。如遇到其他问题,请查阅 Cloudflare 官方文档或寻求社区帮助。

相关推荐
JianZhen✓19 分钟前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo25 分钟前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
七夜zippoe35 分钟前
多轮对话管理:Session/记忆在 Java 后端怎么存(存储设计实战)
java·开发语言·ai·session·记忆
laoyeye8311 小时前
手写 vLLM 分页 KV Cache(一):先从 Continuous Batching 调度器看全局
github
屿华AI1 小时前
AUTOSAR 实战-诊断工具 | 基于 Python 与 USB-CANFD 的 UDS 诊断测试工具设计与实现
开发语言·python·测试工具
SomeOtherTime1 小时前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust
徐小夕2 小时前
开源!我们用知识图谱重构了电子档案,AI 驱动全文智能关联
前端·vue.js·github
黑客笔记2 小时前
Python 进程池和线程池:用等待任务理解并发
开发语言·python
一条Go4 小时前
开源新生代雷达 · 第 13 期
github
一条Go4 小时前
Kubernetes 多集群接入:kubeconfig 只进不出
后端·架构·github