Miniflare Not Working: workerd Cannot Find '@cloudflare/workerd-darwin-arm64'

[k1z3]

Hello.
I develop web applications using Next.js 15 (App Router).

I have a question.
I want to use D1 and set up a Miniflare development environment.
I tried writing a simple script, but I couldn't get it to work in the Node.js runtime (not the Edge runtime).

Here is my code:

const Miniflare = (await import('miniflare')).Miniflare
const mf = new Miniflare({
  modules: true,
  liveReload: true,
  script: '',
  d1Databases: {
    __D1: 'xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    __D1_PREVIEW: 'xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,
  },
})

However, I encountered the following error:

Error: The package "@cloudflare/workerd-darwin-arm64" could not be found, and is needed by workerd.

If you are installing workerd with npm, make sure that you don't specify the
"--no-optional" flag. The "optionalDependencies" package.json feature is used
by workerd to install the correct binary executable for your current platform.
    at (rsc)/./node_modules/miniflare/node_modules/workerd/lib/main.js (.next/server/vendor-chunks/miniflare.js:30:1)
    at __webpack_require__ (.next/server/webpack-runtime.js:33:43)
    at (rsc)/./node_modules/miniflare/dist/src/index.js (.next/server/vendor-chunks/miniflare.js:20:1)
    at __webpack_require__ (.next/server/webpack-runtime.js:33:43)
    at __webpack_require__.t (.next/server/webpack-runtime.js:76:38)
    at async getD1Session (src/components/utils/cloudflare/d1/getD1Session.ts:20:25)
  18 |       console.log(c)
  19 |
> 20 |       const Miniflare = (await import('miniflare')).Miniflare
     |                         ^
  21 |       const mf = new Miniflare({
  22 |         modules: true,
  23 |         liveReload: true,

I have installed @cloudflare/workerd-darwin-arm64 via workerd and confirmed that the binary file exists in node_modules.
Could you help me resolve this issue or suggest the best practice for setting up Miniflare with D1?

Thanks!

---

• M1 mac mini (2020)
  • macOS Sequoia 15.3
• Node.js 20.13.1
  • yarn 4.5.3
  • Next.js 15.1.6 (App router)
  • Miniflare 3.20250129.0
  • workerd 1.20250204.0
• Command

  % next dev

[k1z3]

I resolved it myself.

I wanted to set up a D1 development environment locally and came across the OpenNext project during my research.

OpenNext allows us to run a local D1 environment using only wrangler.toml.

'use server'

import { D1Database } from '@cloudflare/workers-types'

export const getD1Session = async () => {
  if (process.env.D1) {
    return process.env.D1
  } else {
    const { getCloudflareContext } = await import('@opennextjs/cloudflare')
    return (getCloudflareContext().env as any).__D1 as D1Database  
  }
}

Have a nice day!