Shopify 上的 APP 能做本地开发么？CLI 跑起来就报错怎么回事

去年帮一个朋友搭 Shopify App，他那项目连自己的后端，要本地调试。我们踩过的坑给你列几个：
1. 先确认你的 Partner Dashboard 里 App 配置的"App URL"和"Allowed redirection URL(s)"都指向了本地端口（比如 http://localhost:3000/auth/callback 之类的）。这个不对，跑起来第一个报错就是 redirect_uri 不匹配。
2. CLI 初始化完记得先 npm install，不要跳过。有的教程说"直接 run"，当场报错。
3. 如果报 403，多半是 OAuth 流程里的 API key 和 secret 写死了，或者你用了多个 Partner 账号。检查一下 .env 文件里的 SHOPIFY_API_KEY 和 SHOPIFY_API_SECRET 是不是空的。
本地跑 Shopify App 完全可行，我朋友那项目后来正常上线了，前后就花了三天调通。难点不在 CLI，在配置对。

其实你想反了，本地开发不是不能做，而是 Shopify 的本地开发体验相比其他平台（比如 WooCommerce）确实烂一截。人家是设计成"在线编辑器 + Partners CLI"一条龙，鼓励你在网页上改，而不是在本地搭环境。
我工厂开发过几个主题，最顺的方式反而是：本地用 VS Code 写完，然后通过 Shopify CLI 的 shopify theme push 推到线上。调试用 Dev Console，不跑本地服务器。如果你非要跑 App 级别的本地开发，那要么用 Docker 把整个 stack 包起来，要么接受偶尔崩一崩。
总之，本地开发可以，但你要有心理准备，这不是拉个 npm start 就能跑通的东西。特别是新手，别一开始就跟 CLI 死磕，可能先把线上主题改明白更划算。

楼上说得对一半，但我不同意"难点不在 CLI，在配置"。
CLI 本身就是坑。2025 年新的 Remix 模板变化很大，你搜到的教程可能是基于旧的 Node.js 模板的。如果你跑的是 shopify app init 选 Remix，那依赖关系复杂很多，而且它自带的 proxy 和 session 处理逻辑跟以前完全不同。我建议新手直接选 Build a Node.js app 而不是 Remix，少很多破事。
前提是你熟悉 Express 或 Koa。如果不熟，那 Remix 也可以，只是做好翻文档的准备。
还有，本地开发环境最好用 --tunnel 参数自带的方式（CLI 会自动弹出一个 ngrok 隧道），不要自己额外开 ngrok，省得端口冲突。这个我踩过两次了。

这事我也想问，当年刚入坑的时候差点被搞崩。
我试过最坑的一次，按照文档一步一步来，最后提醒我端口被占用，我把 8080 关了还是不行，结果发现是公司 VPN 把 localhost 给路由了。Shopify 的 CLI 对网络环境很敏感，尤其是企业网络或者翻墙状态下。
有个小技巧：你试试 shopify app dev --tunnel-url=https://your-ngrok-url.ngrok.io 把隧道出口强制定死。如果你用的是 ngrok，看是不是免费版每个小时断一次。我以前就是因为免费 ngrok 断了导致 token 失效，一直以为是代码问题。
还有一点，你 shopify app init 时候选的文件夹路径里不能有中文，最好也别有空格，否则后面各种玄学报错。这个我在 macOS 上栽过。反正本地开发可以搞，但要先排除网络和环境干扰，不是非得云服务器。

哈哈，这个问题我亏过，不只一次。最开始我图省事，直接线上改 theme.liquid，结果改错了恢复不了，备份都没有。后来才老老实实搞本地开发。
说点实在的：你本地跑 Shopify App，最烦的不是代码，是每次改完都要重新 shopify app dev 重启服务，加载很慢。后来我不耐烦了，直接买了个最低配的 DigitalOcean 云服务器（5 刀/月）挂上去开发，至少不用每天盯着 terminal 看。但本地开发能搞定就搞定，别像我一样折腾服务器，贵且不省事。
对了，如果你用的是 Windows，ngrok 的坑更多，建议搞个 WSL2 环境跑，不然各种路径问题烦死你。

你这个报 403 和 token 错误，确定不是 App 的 API scopes 没勾？Shopify 现在对权限要求很严，你 App 里要用什么 API，先在 Partner Dashboard 的 Configuration 里把相应 scopes 打上勾，然后重新安装一次 App。不改 scopes 直接跑，就算 token 能拿到，调用 API 时也是 403。
我之前做的一个邮件订阅功能，就漏了个 read_customers 权限，调了 2 小时才发现。本地开发和线上部署都是一个原理，权限不对就跑不通。