웹 성능 컨설턴트: Medusa.js

Medusa.js, 모듈식 headless commerce와 frame해야 할 성능

Medusa.js는 e-commerce stack를 end-to-end로 소유하려는 팀을 위한 Shopify의 open-source 대안으로 자리잡았습니다. 2.0 버전은 core를 모듈식 architecture(Module, Workflow, Link)로 다시 작성하며, 엄격한 backend / storefront 분리 — 일반적으로 Store API 또는 Server Action을 통해 Medusa API를 호출하는 Next.js storefront — 를 채택했습니다.

이 모듈성은 design 강점이지만, catalog가 수천 개 product를 넘거나 트래픽이 증가하자마자 누적되는 성능 부채 각도를 엽니다. Medusa의 웹 성능 최적화 angle은 multi-layer입니다: catalog 및 pricing 쿼리에 대해 profile된 Postgres, cache 및 event를 위해 구성된 Redis, sync와 async 사이에 분할된 workflow, 엄격한 JS budget를 가진 ISR 또는 streaming의 Next.js storefront.

Pricing engine과 catalog, 첫 work-stream

Medusa의 pricing engine은 매 요청마다 복잡한 규칙(price list, currency, customer group, region, sales channel)을 해결합니다. 가격이 표시되는 50개 product card가 있는 product listing에서 relation이 제대로 preload되지 않으면 계산이 cascading 쿼리를 트리거할 수 있습니다.

Medusa logger와 Postgres profiler(pg_stat_statements, EXPLAIN ANALYZE)를 통한 진단이 느린 쿼리를 즉시 노출합니다. 전체 fetch 대신 타게팅된 select + relations로의 전환과 안정적인 가격 계산에 대한 Redis cache는 catalog endpoint에서 API TTFB를 40~70% 떨어뜨립니다. 고-SKU 스토어에서는 종종 storefront가 LCP에서 녹색이 되도록 하는 lever입니다.

Workflow와 event, async by default

Medusa 2.0은 multi-step 작업(주문 생성, 환불, 결제 캡처)을 idempotency 및 compensation과 함께 orchestrate하는 Workflow Engine을 도입합니다. 강력하지만, 제대로 분할되지 않은 workflow는 async여야 했던 step를 동기로 실행합니다: 확인 email, ERP sync, Meilisearch 또는 Algolia index 업데이트.

Refactoring — 중요한 step는 동기(결제 캡처, stock), 보조 step는 Subscriber + Redis event를 통해 async — 는 perceived 주문 생성 지연을 수백 ms 떨어뜨립니다. Laravel queue와 같은 logic이지만, Medusa의 workflow primitive에 의해 운반됩니다.

Next.js storefront, Core Web Vitals 전장

Storefront는 일반적으로 backend(Next.js, Remix, Astro)에서 분리됩니다. Google이 측정하는 LCP, CLS, INP가 실제로 펼쳐지는 곳입니다. 고전적 함정: catalog page에서 ISR 대신 어디서나 revalidate: 0, RSC + streaming 대신 전체 hydration, checkout에서만 유용한 Stripe 또는 PayPal SDK가 home에 로드됨.

Storefront 감사는 JS bundle(home에서 250 KB gzip 목표), product image(AVIF format, 올바른 size, fold 아래 lazy), product page의 CDN cache, 정확한 RSC/Client 분할을 다룹니다. 제대로 framed된 Next.js Medusa storefront에서는 3G 모바일에서도 sub-1.5s LCP와 sub-200ms INP를 유지합니다.