nextjs-starter-medusa
一个集成了Medusa和Next.js 15的电商前端启动模板，支持完整购物流程。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
已弃用的电商前端模板，建议改用新项目。
核心功能
- 完整电商功能：商品详情、列表、购物车、Stripe支付、用户账户
- 基于Next.js 15最新特性：App Router、服务端组件、流式渲染
避坑指南
- •此项目已弃用，官方推荐使用 dtc-starter。若继续使用可能无法获得后续更新和安全修复。
适用场景
- 快速启动基于Medusa后端的前端商城
详细介绍
Medusa Next.js Starter 是一个将 Medusa 电商模块与 Next.js 15 结合的开源模板，用于快速搭建高性能电商前端。它支持完整的电商功能：商品详情、商品列表、购物车、Stripe 支付、用户账户和订单查看。利用 Next.js 15 的 App Router、服务端组件、流式渲染和静态预渲染。注意：此仓库已弃用，请使用更新的 dtc-starter。
常见问题与排障 (2)
故障排除如何修复在 Medusa V2 中使用 queryParams 的 listProducts 时出现的 'Property collection_id does not exist on type StoreProductParams' 错误？
此TypeScript错误是由于Medusa V2的StoreProductParams中缺少collection_id、tag_id和is_giftcard等queryParams属性的类型定义所致。修复已通过PR #517（https://github.com/medusajs/nextjs-starter-medusa/pull/517）合并到Next.js starter仓库中。请将项目更新至该starter的最新版本，或同步类型补丁以解决此问题。
故障排除为什么 Medusa storefront 在创建了一个没有国家的 region 后会陷入无限重定向循环？
当在 Medusa Admin 中创建区域时未分配任何国家，就会发生此问题。由于没有配置有效的发货国家，店铺前台会进入无限重定向。解决方法：登录 Medusa Admin，编辑受影响的区域，并添加至少一个国家。如果无法编辑，请删除该区域并重新创建并分配国家。这是一个已知错误（#502）；永久性解决方案将禁止创建没有国家的区域。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保本机有Medusa服务器（端口9000）并运行
步骤2：克隆仓库并进入目录：git clone ... && cd nextjs-starter-medusa
步骤3：复制环境变量：cp .env.template .env.local
- 步骤1：确保本机有Medusa服务器（端口9000）并运行
- 步骤2：克隆仓库并进入目录：git clone ... && cd nextjs-starter-medusa
- 步骤3：复制环境变量：cp .env.template .env.local
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
直接删除项目文件夹即可卸除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs