Expo构建的React Native中Linking.canOpenURL返回false问题

问题分析 #

本地调试时Expo开发环境会自动适配URL协议权限，但打包成独立APK后，Android系统需要明确的intent过滤配置才能识别wa.me这类唤起第三方应用的链接，这是导致canOpenURL返回false的核心原因。另外，未编码的特殊字符也可能导致URL格式无效。

解决步骤 #

1. 配置app.json的Android Intent过滤 #

在项目的app.json中，给Android添加针对wa.me链接的intent过滤规则，让系统允许应用识别并处理这类链接：

{
  "expo": {
    // 其他配置...
    "android": {
      "intentFilters": [
        {
          "action": "VIEW",
          "data": [
            {
              "scheme": "https",
              "host": "wa.me",
              "pathPrefix": "/"
            }
          ],
          "category": [
            "BROWSABLE",
            "DEFAULT"
          ]
        }
      ]
      // 其他Android配置...
    }
  }
}

2. 对消息内容做URL编码 #

如果whatsappMessage包含空格、中文或特殊字符，直接拼接会破坏URL结构，导致canOpenURL判定链接无效。必须用encodeURIComponent编码：

const encodedMessage = encodeURIComponent(whatsappMessage);
const url2 = `https://wa.me/${whatsappNumber}?text=${encodedMessage}`;

3. 跳过检测直接调用openURL（备选方案） #

Android系统对canOpenURL有严格的权限限制，即使配置了intent过滤也可能出现误判。可以直接尝试打开链接，通过捕获异常处理WhatsApp未安装的情况：

Linking.openURL(url2)
  .catch(() => {
    Alert.alert('未安装WhatsApp，请先安装后重试');
  });

4. 升级Expo SDK到最新稳定版 #

部分旧版本Expo SDK在Linking模块的兼容性上存在问题，运行expo upgrade升级到最新版本，能避免一些已知的打包后权限异常问题。

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