Node.js中Shopify API初始化失败，配置参数缺失问题求助

数据老陈

2026-7-26

Shopify API初始化错误：缺失apiKey、apiSecretKey、hostName的解决办法

重要提醒

不要直接修改node_modules/@shopify/shopify-api/lib/config.js文件——依赖包更新后你的修改会被覆盖，正确做法是在自己项目的代码中配置Shopify API参数。

配置项获取与设置

1. apiKey & apiSecretKey

登录Shopify合作伙伴后台（或店铺后台的「应用→开发应用」）
进入你的应用详情页，在「API密钥」板块复制这两个值，填入你的项目配置中。

2. hostName

hostName是你的应用可被公开访问的域名，分两种场景：

线上部署场景：填你应用的正式域名，比如my-shopify-app.example.com（不要加http://或https://前缀）
本地开发场景：必须用反向代理工具（如ngrok）暴露本地服务，此时hostName就是ngrok生成的转发域名，比如abc123.ngrok.io

正确配置示例（项目内的shopify.js）

import { shopifyApi } from '@shopify/shopify-api';
import { shopifyApp } from '@shopify/shopify-app-express';

// 初始化Shopify API
const shopify = shopifyApi({
  apiKey: '你的API_KEY',
  apiSecretKey: '你的API_SECRET_KEY',
  hostName: '你的应用域名', // 比如 abc123.ngrok.io 或 my-app.com
  apiVersion: '2024-04', // 可替换为LATEST_API_VERSION
  isEmbeddedApp: true,
  scopes: ['read_products', 'write_orders'], // 根据业务需求设置权限范围
});

// 创建Shopify Express应用
const shopifyAppInstance = shopifyApp({
  shopify,
  // 其他应用配置（如auth路径、webhooks等）
});