Shopify应用PostgreSQL Session Storage配置失败求助

算力阿峰

2026-8-25

问题根源

你遇到的错误是因为使用的@shopify/shopify-api版本和参考的文档版本不匹配：

你参考的文档对应v6及更早的版本，这类版本中PostgreSQLSessionStorage嵌套在Shopify.Auth.Session下
当前你使用的是v7+版本，该版本对存储类的结构做了扁平化调整，PostgreSQLSessionStorage不再挂载在Auth.Session路径下，直接作为包的顶级导出存在

解决方案

方案1：适配v7+版本（推荐）

首先确保安装PostgreSQL依赖包：

npm install pg

然后使用正确的导入和初始化方式：

import Shopify, { PostgreSQLSessionStorage } from '@shopify/shopify-api';

Shopify.Context.initialize({
  // 方式1：用连接字符串初始化
  SESSION_STORAGE: new PostgreSQLSessionStorage("postgres://username:password@host/database"),
  // 方式2：用独立参数初始化
  // SESSION_STORAGE: PostgreSQLSessionStorage.withCredentials(
  //   "host.com",
  //   "thedatabase",
  //   "username",
  //   "password",
  // ),
  // 补充其他必填配置项
  API_KEY: '你的API密钥',
  API_SECRET_KEY: '你的API密钥',
  SCOPES: ['read_products', 'write_orders'], // 按需修改权限
  HOST_NAME: '你的应用域名',
});