部署于Azure服务器的Node API发送web-push通知失败求助

1. 检查Azure出站网络配置 #

• 如果你使用的是Azure App Service，进入资源控制台的「网络」板块，查看出站流量规则，确认已放开目标地址为任意、端口为443的HTTPS出站权限。Web Push通知推送本质是你的服务向各浏览器厂商的推送服务（谷歌FCM、火狐推送服务、苹果APNs等）发起HTTPS请求，所有请求都会走443端口，规则限制出站拦截会直接导致推送失败。
• 如果你使用的是Azure虚拟机、容器实例等资源，检查关联的网络安全组(NSG)的出站规则，确认允许443端口出站的规则优先级高于任何拒绝规则。

2. 增加错误捕获定位具体原因 #

你当前代码没有对推送请求做错误捕获，无法判断是网络拦截、推送服务拒绝还是其他问题，先修改代码添加错误日志输出：

// /api/notify接口内的遍历逻辑替换为以下内容
await Promise.all(notificationClient.map(async clientSub => {
  try {
    await webpush.sendNotification(clientSub, JSON.stringify(payload));
    console.log('推送成功，目标endpoint:', clientSub.endpoint);
  } catch (err) {
    // 错误信息会打印到Azure应用日志中，可直接查看具体报错
    console.error('推送失败:', {
      statusCode: err.statusCode,
      message: err.message,
      body: err.body
    });
  }
}));

注意：需要同时把/api/notify接口的回调函数修改为async异步函数，否则await语法会报错。

如果日志中出现ECONNRESET、连接超时、ECONNREFUSED类报错，基本可以确认是出站请求被Azure网络规则拦截。

3. 配置有效性检查 #

• 确认部署到Azure的代码中VAPID公钥、私钥和本地使用的一致，没有配置错误。
• 把webpush.setVapidDetails第一个参数的邮箱地址不要用示例的example@yourdomain.org，替换为真实可用的邮箱，部分推送服务会校验邮箱有效性，无效邮箱会直接拒绝推送请求。
• 调用/api/notify接口时，确认返回的ClientsNotified数值大于0：你当前的订阅信息存在内存数组中，服务重启后所有订阅信息会清空，部署完成后需要客户端重新发起订阅请求才能正常推送。

4. 代理适配（如果Azure服务需要走代理出站） #

如果你的Azure资源配置了VNet集成、需要走代理才能访问公网，需要给webpush配置代理：

// 先安装依赖：npm install https-proxy-agent
const HttpsProxyAgent = require('https-proxy-agent');
const proxy = process.env.HTTPS_PROXY || process.env.http_proxy;
if (proxy) {
  const agent = new HttpsProxyAgent(proxy);
  webpush.setAgent(agent);
}

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