使用Express开发Shopify私有应用时遇URL参数类型错误求助

安全阿岳

2026-5-13

解决Express版Shopify应用验证时的TypeError问题

我一眼就定位到问题啦！你遇到的TypeError [ERR_INVALID_ARG_TYPE]错误，核心原因是**express-shopify-auth的baseUrl参数配置错误**。

错误根源

你在代码里把baseUrl设置成了port（数字类型）：

baseUrl: port,

但这个参数要求传入的是完整的字符串格式HTTPS地址（也就是你ngrok生成的转发URL），而不是单纯的端口号。错误栈里提到的url.resolve方法在处理数字类型参数时，会直接抛出类型不匹配的错误。

修复步骤

复制ngrok的HTTPS地址：打开ngrok终端，复制类似https://abc123-45-67-89-01.ngrok.io的完整HTTPS URL（不要加端口，ngrok已经帮你完成端口映射）。
更新.env文件：新增一个环境变量，比如：
```
BASE_URL=https://abc123-45-67-89-01.ngrok.io
```

修改server.js的配置：把baseUrl改成读取这个环境变量，确保是字符串类型：

// 先解构出BASE_URL
var { SHOPIFY_API_SECRET_KEY, SHOPIFY_API_KEY, BASE_URL } = process.env;

// 然后修改auth配置
var auth = ShopifyAuth.create({
  appKey: SHOPIFY_API_KEY,
  appSecret: SHOPIFY_API_SECRET_KEY,
  baseUrl: BASE_URL, // 替换原来的port
  authPath: '/auth',
  authCallbackPath: '/auth/callback',
  authSuccessUrl: '/success',
  authFailUrl: '/fail',
  scope: ['read_products'],
  shop(req, done) {
    return done(null, req.query.shop);
  },
  onAuth(req, res, shop, accessToken, done) {
    req.session.shopify = { shop, accessToken };
    return done();
  },
});