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专属依赖:
该配置可自动为http、https、url等常用Node内置模块注入浏览器兼容实现,避免拉取http2等Node专属服务端依赖触发加载失败。:builds {:app {:target :browser :js-options {:npm-node-compat true :resolve {"http2" {:target :empty}}}}} - 修复
./framer模块找不到的报错
将shadow-cljs升级至2.15.0及以上版本,该版本已修复monorepo分包场景下的ESM路径截断bug,不会出现将包内正确路径错误解析为./framer的问题;同时需统一所有aws-amplify相关子包的版本,避免混装不同大版本依赖导致的路径引用错位。 - 验证配置流程
完成上述调整后,先调用(Amplify/configure awsAmplifyConfig)传入项目配置,再验证Amplify实例的内部属性不再为null,Auth实例可正常调用方法。
内容的提问来源于stack exchange,提问作者Andrii Khamuliak
相关产品推荐
相关产品推荐

