Express.js使用自定义URL Scheme时重定向URL错误的解决方法

问题场景 #

使用Express.js开发Node.js用户验证功能时，尝试通过自定义URL Scheme（myapp://）重定向唤起安卓应用，但Express自动将当前主机和路径追加到目标URL前，导致重定向地址错误，无法正常唤起App。

环境配置 #

APP_URL=myapp://confirm

现有路由代码 #

router.get('/api/verify', async (req, res) => {
  try {
    const { token } = req.query;
    if (!token) {
      return res.status(400).json({ message: 'Verification token is required' });
    }

    const result = await verifyUser(token);

    if (result.verified) {
      const redirectUrl = `${process.env.APP_URL}?email=${encodeURIComponent(result.email)}`;
      res.redirect(302, redirectUrl);
    } else {
      res.status(404).json({ message: 'User not found or already verified' });
    }
  } catch (error) {
    console.error('Error verifying user:', error);
    res.status(500).json({ message: error.message });
  }
});

问题现象 #

• 预期重定向地址：myapp://confirm?email=user@example.com
• 实际重定向地址：http://localhost:3000/v1/api/myapp://confirm?email=user@example.com
• 触发错误：Cannot GET /v1/api/myapp://confirm，无法唤起安卓应用，反而发起无效API请求

解决方案 #

问题根源是Express的res.redirect()方法会将不含://的URL视为相对路径，自动拼接当前请求的主机和路径。自定义URL Scheme属于特殊绝对URL，需让Express识别其为外部绝对地址，可通过以下两种方式修复：

方式1：直接设置Location响应头 #

跳过Express的相对路径处理逻辑，手动设置Location响应头并返回302状态码：

if (result.verified) {
  const redirectUrl = `${process.env.APP_URL}?email=${encodeURIComponent(result.email)}`;
  res.setHeader('Location', redirectUrl);
  res.status(302).send();
}

方式2：使用URL对象构造标准绝对URL #

通过URL对象确保重定向地址格式正确，避免字符串拼接可能出现的错误：

if (result.verified) {
  const redirectUrl = new URL(process.env.APP_URL);
  redirectUrl.searchParams.set('email', encodeURIComponent(result.email));
  res.redirect(302, redirectUrl.toString());
}

关键验证点 #

• 确认process.env.APP_URL已正确加载，值为myapp://confirm（可通过console.log(process.env.APP_URL)打印验证）
• 确保最终生成的redirectUrl包含://，让Express识别为绝对外部URL

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