{"record":{"id":"fc33fd9ee26c58ad","repo":"medusajs/medusa","slug":"index-engine-failed-to-continue-sync","errorCode":null,"errorMessage":"[Index engine] Failed to continue sync","messagePattern":"\\[Index engine\\] Failed to continue sync","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/modules/index/src/services/index-module-service.ts","lineNumber":375,"sourceCode":"            internal: true,\n          },\n        })\n      })\n\n      return\n    }\n\n    try {\n      const entities = await this.configurationChecker_.checkChanges()\n\n      if (!entities.length) {\n        return\n      }\n\n      return await this.dataSynchronizer_.syncEntities(entities)\n    } catch (e) {\n      this.logger_.error(e)\n      throw new Error(\"[Index engine] Failed to continue sync\")\n    }\n  }\n\n  private async fullSync() {\n    if (!this.#isWorkerMode) {\n      await this.baseRepository_.transaction(async (transactionManager) => {\n        await promiseAll([\n          this.indexMetadataService_.update(\n            {\n              selector: {\n                status: [\n                  IndexMetadataStatus.DONE,\n                  IndexMetadataStatus.ERROR,\n                  IndexMetadataStatus.PROCESSING,\n                ],\n              },\n              data: {\n                status: IndexMetadataStatus.PENDING,","sourceCodeStart":357,"sourceCodeEnd":393,"githubUrl":"https://github.com/medusajs/medusa/blob/5e06e544a296b9033f20f71f11c559f81a0e5739/packages/modules/index/src/services/index-module-service.ts#L357-L393","documentation":"continueSync (part of sync) wraps entity synchronization in a try/catch; if the data synchronizer throws for any entity, the original error is logged and this generic '[Index engine] Failed to continue sync' error is rethrown.","triggerScenarios":"Resuming an interrupted index synchronization where a entity's data fails to transform/insert — schema drift, connection drops, or an entity listener error inside the synchronizer.","commonSituations":"Index worker restarting mid-sync; changed module entity definitions without re-running the index setup.","solutions":["Check the preceding logger_ output for the underlying exception and fix that","Re-run sync({ strategy: 'full' }) to rebuild from scratch if state is inconsistent","Ensure the index module config/schema matches current module versions"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try { await indexService.sync() } catch (e) { if (e.message === '[Index engine] Failed to continue sync') { await indexService.sync({ strategy: 'full' }) } else throw e }","preventionTips":["Watch the preceding log line for the root cause","Run full sync when incremental state is corrupted"],"tags":["index","sync","data-pipeline"],"backgroundTag":"sync-job-failed","analyzedSha":"5e06e544a296b9033f20f71f11c559f81a0e5739","analyzedAt":"2026-08-27T07:24:39.599Z","schemaVersion":2},"datasetVersion":"2026-08-27T08:17:20.692Z"}