用途:该技能面向使用 Next.js 与 Netlify 的项目,用于部署与配置、Serverless Functions 开发,以及 Webhook 与性能问题的排查。
主要能力:
- 部署与配置:编写 netlify.toml(build、functions、redirects、headers)、设置环境变量、配置 Git 持续部署(GitHub、GitLab、Bitbucket)。
- Functions 开发:创建 Netlify 函数,处理 Twilio、Telnyx、Stripe 等 Webhook,调试超时,实现后台处理长任务。
- 故障排查:修复 Webhook 超时、"Function not found"(404)、环境变量问题、构建与部署失败。
- SMS/电话项目:Twilio-Aldea 类项目的 Webhook 即时确认与后台处理、签名校验。
必要用法:
- 通过 CLI 先关联项目:netlify link,或创建 .netlify/state.json 写入 siteId;用 netlify sites:list 查 ID,netlify status 验证。
- 环境变量:netlify env:set、netlify env:import、netlify env:list、netlify env:get、netlify env:unset、netlify env:clone;改后可能需要重新部署才在生产生效。客户端变量需 NEXT_PUBLIC_ 前缀。
- 部署:git push 自动部署,或 netlify deploy --prod。本地调试用 netlify dev,日志用 netlify functions:log function-name --stream。
限制:函数默认超时为 10 秒(免费层),Pro 层 26 秒;文件名以 -background.ts 结尾的后台函数超时 15 分钟。Next.js 集成由 OpenNext 适配器(@opennextjs/netlify)支持,替代旧的 @netlify/plugin-nextjs。其他平台、收费等细节暂未提供。