Saleor Checkout App连接报错：connect ECONNREFUSED 127.0.0.1:443

报错核心原因 #

connect ECONNREFUSED 127.0.0.1:443 说明Checkout App尝试通过HTTPS连接本地127.0.0.1的443端口，但该端口无服务监听，问题根源在于Saleor API地址配置错误。

目标环境变量的本地配置方案 #

你修改的是NEXT_PUBLIC_SALEOR_API_URL变量，本地开发时根据场景不同配置如下：

场景1：使用本地saleor-platform的Saleor实例 #

本地saleor-platform默认以HTTP协议运行在8000端口，直接填写：

NEXT_PUBLIC_SALEOR_API_URL=http://localhost:8000/graphql

⚠️ 不要填https://localhost:8000/graphql，否则会自动转至443端口导致连接失败。

场景2：使用ngrok/saleor app tunnel暴露Saleor实例 #

填写隧道提供的HTTPS完整地址，追加/graphql路径：

NEXT_PUBLIC_SALEOR_API_URL=https://[你的隧道域名]/graphql

替换[你的隧道域名]为ngrok或saleor app tunnel分配的实际域名（例如abc123.ngrok.io）。

额外排查要点 #

• 同步Checkout App的API配置：确保saleor-app-checkout项目的.env文件中，SALEOR_API_URL变量和上述配置完全一致，Checkout App自身也需要调用Saleor API，配置不一致会引发连接错误。
• 设置正确的APP_URL：导入Checkout App到Saleor时，需将Checkout App的APP_URL环境变量设为ngrok/tunnel的地址（例如https://abc123.ngrok.io），否则Saleor无法回调到Checkout App。
• 验证CORS配置：确认Saleor的CORS设置允许Checkout App的访问地址（本地开发时为http://localhost:3001，隧道模式下为隧道域名），saleor-platform默认配置已包含本地地址，若有自定义修改需检查。

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