You need to enable JavaScript to run this app. shadow-cljs中ClojureScript升级aws-amplify v3后Amplify、Auth加载异常
优惠活动
大模型
产品
解决方案
定价
更多

shadow-cljs中ClojureScript升级aws-amplify v3后Amplify、Auth加载异常

aws-amplify v3.3.4 适配 shadow-cljs/ClojureScript 项目异常排查

异常场景记录

历史正常版本表现

aws-amplify v1.2.4 版本下,项目通过如下ClojureScript代码引入模块可正常运行:

(ns app.core
    ["aws-amplify" :default Amplify]
    ["aws-amplify" :refer [Auth]])

控制台打印验证结果为:Amplify是合法模块对象,Auth为AuthClass实例,全链路功能正常。

升级后异常表现

将aws-amplify升级至v3.3.4版本后,上述引入方式获取的两个值均不可用。
尝试按新版本拆分包结构引入依赖:

["@aws-amplify/core" :as amplify-core]
["@aws-amplify/auth" :as amplify-auth]

出现三类连续异常:

  • 从@aws-amplify/core引入的Amplify虽为AmplifyClass实例,但内部几乎所有属性均为null;调用(.configure amplify-core/Amplify awsAmplifyConfig)操作表面无报错,但配置未实际生效
  • 从@aws-amplify/auth引入的对象打印后仅为{__esModule: true},无法从中获取实际的Auth类
  • 控制台输出大量shadow-cljs模块加载失败警告,涉及http2、AWS SDK相关依赖加载异常,最终提示app.core.js加载失败,报错Module not provided: ./framer

核心问题根因

  • aws-amplify v3.x 将原单聚合包重构为monorepo多包结构,ESM导出逻辑完全调整,不再兼容ClojureScript旧的:default/:refer从根包直接提取导出值的写法
  • v3.x 内部依赖默认引用适配Node.js环境的模块(如http2、部分AWS SDK服务端子包),shadow-cljs默认浏览器构建配置未做Node模块兼容shim,直接拉取服务端依赖到浏览器构建链路,触发加载异常
  • ./framer路径报错是shadow-cljs的模块解析兼容问题:旧版本对monorepo分包的ESM相对路径解析存在截断bug,无法正确定位包内文件路径

分步解决方案

  • 修正模块引入写法,匹配v3.x的ESM导出规则
    不要使用包别名的方式获取导出值,需明确指定取各子包的默认导出:
    (ns app.core
      ["@aws-amplify/core" :default Amplify]
      ["@aws-amplify/auth" :default Auth])
    
    该写法可直接解决@aws-amplify/auth仅返回{__esModule: true}的问题——v3.x版本的Auth类是@aws-amplify/auth包的默认导出,并非命名导出,通过:as引入仅能拿到整个ES模块的空壳对象。
  • 调整shadow-cljs构建配置,补全Node模块兼容能力
    在shadow-cljs.edn的构建配置中,为浏览器环境替换Node专属依赖:
    :builds {:app {:target :browser
                   :js-options {:npm-node-compat true
                                :resolve {"http2" {:target :empty}}}}}
    
    该配置可自动为http、https、url等常用Node内置模块注入浏览器兼容实现,避免拉取http2等Node专属服务端依赖触发加载失败。
  • 修复./framer模块找不到的报错
    将shadow-cljs升级至2.15.0及以上版本,该版本已修复monorepo分包场景下的ESM路径截断bug,不会出现将包内正确路径错误解析为./framer的问题;同时需统一所有aws-amplify相关子包的版本,避免混装不同大版本依赖导致的路径引用错位。
  • 验证配置流程
    完成上述调整后,先调用(Amplify/configure awsAmplifyConfig)传入项目配置,再验证Amplify实例的内部属性不再为null,Auth实例可正常调用方法。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.21 21:36:05