Expo SDK 52开发构建报错：import声明需置于模块顶层

针对你遇到的Expo SDK 52开发构建启动时报import declaration must be at top level of module错误，但Expo Go运行正常的问题，以下是几个可能的原因和对应的排查/解决步骤：

可能原因及解决方法 #

1. Metro缓存残留导致编译异常 #

即使未修改Metro/Babel配置，旧的缓存产物可能和新代码冲突，引发语法检查错误。

• 执行命令清除Metro缓存：

  npx expo start --clear
  

  之后重新生成开发构建并测试。

2. 第三方依赖内部存在非顶层import #

部分第三方库的代码可能存在非顶层import的写法，Expo Go的打包逻辑对这类语法兼容性更强，而开发构建的Metro打包器会严格执行ES模块规范。

• 排查最近新增的依赖：临时移除近期添加的npm包，逐个恢复测试，定位到引发问题的依赖。
• 查看依赖源码：如果怀疑某个依赖有问题，直接查看其node_modules下的源码，确认是否存在函数/条件语句内的import。

3. 开发构建默认配置更严格 #

Expo SDK 52的开发构建可能默认启用了更严格的语法检查规则，而Expo Go使用的打包配置相对宽松。

• 检查eas.json中的build配置：确认是否有额外开启minify、strict等可能增强语法检查的参数，尝试临时关闭后重新构建。

4. 隐藏的非顶层import代码 #

虽然你确认代码中没有此类问题，但可能存在容易忽略的场景：

• 动态import误用：在普通函数内使用import xxx from 'xxx'（而非import()动态导入语法），这种写法不符合ES模块规范。
• 条件语句内的静态import：比如在if/else块内写静态import，这类代码在Expo Go中可能被打包器兼容，但开发构建会报错。

5. 启用详细日志定位具体错误 #

当前错误日志仅显示编译后的代码行号，无法定位到源码，建议启动开发构建时添加verbose参数获取更详细信息：

npx expo start --verbose

通过详细日志找到触发错误的具体源码文件和行号，针对性修复。

内容的提问来源于stack exchange，提问作者Mark4678