{"record":{"id":"898c4f1dee1ee2e6","repo":"gatsbyjs/gatsby","slug":"ignoring-incompatible-adaptertouse-module-ada","errorCode":null,"errorMessage":"Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}","messagePattern":"Ignoring incompatible (.+?)@(.+?) installed by site\\. (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby/src/utils/adapter/init.ts","lineNumber":187,"sourceCode":"    )\n  }\n\n  {\n    // 3. Check if the user has manually installed the adapter and try to resolve it from there\n    const adapterInstalledByUserResults =\n      await tryLoadingAlreadyInstalledAdapter({\n        adapterToUse,\n        installLocation: process.cwd(),\n        currentGatsbyVersion,\n      })\n    if (adapterInstalledByUserResults.found) {\n      if (adapterInstalledByUserResults.compatible) {\n        reporter.verbose(\n          `Using site's adapter dependency \"${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion}\"`\n        )\n        return adapterInstalledByUserResults.loadedModule\n      } else {\n        reporter.warn(\n          `Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}`\n        )\n      }\n    }\n  }\n\n  {\n    // 4. Check if a previous run has installed the correct adapter into .cache/adapters already and try to resolve it from there\n    const adapterPreviouslyInstalledInCacheAdaptersResults =\n      await tryLoadingAlreadyInstalledAdapter({\n        adapterToUse,\n        installLocation: getAdaptersCacheDir(),\n        currentGatsbyVersion,\n      })\n\n    if (adapterPreviouslyInstalledInCacheAdaptersResults.found) {\n      if (adapterPreviouslyInstalledInCacheAdaptersResults.compatible) {\n        reporter.verbose(","sourceCodeStart":169,"sourceCodeEnd":205,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby/src/utils/adapter/init.ts#L169-L205","documentation":"Error \"Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}\" thrown in gatsbyjs/gatsby.","triggerScenarios":"Thrown at packages/gatsby/src/utils/adapter/init.ts:187 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade or downgrade the site-installed adapter to a version compatible with the current Gatsby version","Remove the site-installed adapter to let zero-configuration deployment pick a compatible one","Fix the root incompatibilityReason reported (e.g. peer dependency mismatch on gatsby) and reinstall"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}