You need to enable JavaScript to run this app. Sapper应用本地运行正常,Heroku部署时报错无法找到svelte/internal模块
优惠活动
大模型
产品
解决方案
定价
更多

Sapper应用本地运行正常,Heroku部署时报错无法找到svelte/internal模块

问题根因

本地开发、heroku local web 模式下能正常运行,是因为本地环境会全量安装包含devDependencies在内的所有依赖;但Heroku线上生产环境默认跳过devDependencies的安装流程,叠加@vime/svelte未将对svelte/internal的引用声明为强制运行时依赖、Sapper打包时将第三方svelte组件标记为外部依赖并保留运行时require逻辑的问题,最终触发模块查找失败。

分步修复方案

  • 调整依赖分类:将原本归类在devDependencies下的svelte依赖移动到dependencies数组中,保持版本号与项目当前使用的版本完全一致。

    Heroku生产环境只会完整安装dependencies下的依赖,原配置中放在devDependencies下的svelte会在生产环境依赖清理阶段被移除,即便@vime/svelte已安装,也无法解析到同环境下的svelte/internal模块路径。

  • 调整打包外部依赖规则:修改rollup.config.js中Sapper的external判断逻辑,将@vime/svelte从外部依赖列表中排除,强制rollup将@vime/svelte的编译产物和业务代码一起打包进最终的应用文件,不保留运行时的模块查找逻辑。
  • 统一依赖解析路径:在项目根目录的package.json中新增overrides配置,固定svelte依赖的版本解析路径,避免npm安装时因依赖扁平化策略错乱导致的路径查找失败:
    "overrides": {
      "svelte": "$svelte"
    }
    
  • 本地全流程验证:完成配置修改后,先执行以下步骤模拟Heroku线上环境的运行流程,确认无报错后再推送代码:
    • 删除本地node_modules文件夹与原有构建产物目录
    • 执行npm install --production,匹配Heroku的生产依赖安装规则
    • 执行项目的生产构建命令后运行npm start,验证应用可正常启动

注意事项

  • 不要在依赖安装阶段开启svelte的生产模式裁剪逻辑,避免把svelte/internal的内部方法当冗余代码移除
  • 保持@vime/svelte的版本与项目匹配的svelte版本兼容,不要在调整依赖时随意升级svelte的大版本
  • 若修改后仍存在模块查找报错,可将项目中所有动态引入@vime/svelte组件的逻辑替换为静态顶部引入的形式,进一步减少运行时的模块查找环节

内容的提问来源于stack exchange,提问作者S. W.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.28 02:57:05