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

本地开发Strapi并部署至生产环境的相关问题咨询

Strapi 多环境分离与模型迁移常见问题解答

1. 本地/开发环境的新模型如何同步到生产服务器

  • Strapi 的模型定义(含集合、单类型的字段配置、关联规则等)全部存储在项目根目录src/api/下的对应模块文件中,在开发环境完成模型调整并测试无误后,将该目录的变动代码提交到代码仓库,生产环境拉取最新代码即可完成模型定义同步。
  • 生产环境需关闭content-type builder功能,所有模型调整必须在开发环境完成后再推送代码,避免生产环境直接修改模型导致配置冲突。
  • 若使用 Strapi v4.6+ 版本,可通过官方strapi transfer命令直接同步开发环境的配置(含模型、权限、组件配置等)到生产环境。执行前需先在生产环境配置TRANSFER_TOKEN_SECRET并生成访问令牌,命令格式为strapi transfer --to <生产环境地址> --to-token <生产transfer令牌>。
  • 涉及数据库结构变更的场景,Strapi 启动时会自动执行 schema 比对和迁移,无需手动编写 SQL 修改表结构。

2. 迁移过程中生产环境的数据是否会保留

  • 正常的模型新增、现有模型新增非必填字段、修改字段配置(不修改字段类型/字段名)的操作,生产环境启动时的自动迁移不会改动现有数据,原有数据可完整保留。
  • 如果操作包含删除字段、修改字段类型、重命名字段的场景,Strapi 默认不会自动删除旧字段的数据库数据;但如果开启了STRAPI_AUTO_REMOVE_UNUSED_TABLES_AND_COLUMNS=true环境变量,系统会自动删除数据库中未关联到现有模型的表和字段,导致对应数据丢失。
  • 若需要将旧字段的数据迁移到新字段,需提前手动编写数据迁移脚本,放在项目的src/database/migrations/目录下,Strapi 启动时会按顺序执行迁移脚本完成数据转换。

3. 每次部署迁移前是否需要备份生产环境数据

  • 是,每次涉及模型变更、数据库结构调整的部署,都必须提前备份全量生产数据。
  • 最稳妥的备份方式是直接导出整个 Strapi 关联数据库的 SQL 转储文件,执行部署后如果出现迁移异常,可以直接用备份数据回滚到部署前的状态。
  • 除数据库备份之外,建议同时备份生产环境public/upload目录下的上传资源文件,避免迁移过程中意外丢失用户上传的静态资源。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.07 14:24:03