You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

AIOS CHAT项目部署求助:本地正常Vercel部署报错

部署AIOS CHAT到Vercel/Render免费平台的解决方案

Vercel部署:先排查问题再走标准流程

核心排查点(解决本地正常、线上报错的关键)

  • 检查package.json配置:
    • 确认scripts中的build命令是否正确,比如前端项目常见的react-scripts build(React)、vue-cli-service build(Vue),要保证本地执行npm run build能正常生成产物
    • 确认dependencies里包含所有运行时依赖,不要把依赖只装在devDependencies或者全局,线上部署需要完整的依赖列表
  • 查看Vercel部署日志:
    登录Vercel控制台找到对应项目的部署记录,查看具体报错信息——这是定位问题最快的方式,比如依赖缺失、构建命令执行失败、输出目录配置错误等
  • 配置输出目录:
    多数框架构建后会生成build或dist文件夹,需要在Vercel项目设置的Build & Development Settings里,把Output Directory设为对应的文件夹名

标准部署流程(推荐用仓库关联,避免手动上传遗漏)

  1. 把本地项目推送到GitHub/GitLab仓库
  2. 登录Vercel,点击Add New Project,选择你的仓库
  3. 配置页面选择对应框架的预设(自定义项目选Other),填写Build Command(比如npm run build)和Output Directory
  4. 点击Deploy等待完成

Render部署:分静态站点和后端服务两种情况

纯前端静态站点部署

  1. 将项目推送到GitHub/GitLab仓库
  2. 登录Render,点击New选择Static Site
  3. 关联仓库,填写项目名称,配置Build Command为npm run build,Publish Directory设为构建输出目录(如build/dist)
  4. 点击Create Static Site等待部署完成

带后端的服务部署

  1. 关联仓库后选择Web Service
  2. 配置Build Command(比如npm install && npm run build),Start Command填写项目启动脚本(如npm start)
  3. 如果项目需要环境变量(比如API密钥、端口配置),在Render的环境变量面板添加对应参数
  4. 点击Create Web Service完成部署

通用注意事项

  • 本地先验证npm run build是否能正常生成产物,避免线上构建失败
  • 免费平台有资源限制:Render的免费服务会在闲置时休眠,Vercel的无服务器函数有调用次数上限,测试阶段足够使用
  • 如果用Next.js、Nuxt.js这类框架,直接选择对应框架的预设,平台会自动优化配置

内容的提问来源于stack exchange,提问作者T1mr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.18 14:12:48