Expo SDK47更新后Jest无法读取app.config常量的问题排查

DevOps 小满

2026-7-31

Expo SDK46升级至SDK47后Jest读取app.config环境变量失败的问题解析

核心原因与对应解决办法

1. Mock结构不匹配SDK47的`expo-constants`结构

SDK46起Constants.manifest被废弃，SDK47中expo-constants的环境变量完全迁移到Constants.expoConfig.extra下。你之前的mock直接返回extra属性，和实际结构不符，导致代码读取Constants.expoConfig.extra时拿到undefined。

正确的Mock写法：

jest.mock('expo-constants', () => ({
  expoConfig: {
    extra: {
      api: 'your-test-api-url'
    }
  }
}));

2. `jest-expo`预设的默认Mock覆盖了自定义Mock

SDK47的jest-expo预设可能默认对expo-constants做了基础mock，导致你的自定义mock未生效。可以先取消默认mock再重新定义：

jest.unmock('expo-constants');
jest.mock('expo-constants', () => ({
  expoConfig: {
    extra: {
      api: 'your-test-api-url'
    }
  }
}));

3. 代码中环境变量的读取逻辑存在兼容问题

如果你的代码需要兼容SDK46和47，建议保留兼容逻辑，但测试时需要确保mock覆盖两种情况：

// 代码中的兼容写法
const API_URL = Constants?.expoConfig?.extra?.api || Constants?.manifest?.extra?.api;

// 测试对应的Mock
jest.mock('expo-constants', () => ({
  expoConfig: {
    extra: {
      api: 'your-test-api-url'
    }
  },
  manifest: {
    extra: {
      api: 'your-test-api-url'
    }
  }
}));