Shopify Remix应用添加Background进程后请求转发报错求助

核心原因推测 #

添加后台进程后出现的转发错误，大概率是端口冲突或Shopify CLI多服务端口分配异常，导致主应用的3000端口未正常监听，进而让cloudflared隧道转发请求失败。

解决步骤 #

1. 给后台进程指定独立端口 #

修改background/shopify.web.toml，添加端口配置避免和主应用的3000端口冲突：

name = "pubsub"
roles = ["background"]
port = 3001  # 为后台进程分配独立端口

[commands]
dev = "node pubsub.js"

同时确保pubsub.js中监听的是3001端口，示例代码：

const http = require('http');
const server = http.createServer((req, res) => {
  res.end('Background service running');
});
server.listen(3001, () => {
  console.log('Background service listening on port 3001');
});

2. 验证主应用的端口监听状态 #

启动服务后，查看终端中主应用（Remix）的启动日志，确认是否输出类似Remix App Server started at http://localhost:3000的内容。如果主应用未在3000端口正常启动，排查是否有端口占用或启动错误。

3. 明确指定主应用端口启动 #

如果CLI自动修改了主应用端口，可在启动命令中强制指定：

npm run dev -- --tunnel-url https://shares-cc-scientific-participating.trycloudflare.com:3000 --port 3000

4. 检查后台进程启动逻辑 #

确保后台进程不会阻塞主应用启动，比如避免无限循环中未处理异步逻辑，或启动时抛出未捕获错误导致CLI进程异常。

5. 重置Shopify CLI缓存 #

清除CLI缓存，避免旧服务配置冲突：

shopify app reset

验证 #

完成调整后重新运行启动命令，确认主应用和后台进程均正常启动，再访问测试店铺的应用，检查是否能正常加载。

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