{"record":{"id":"771eb027028e1262","repo":"hashicorp/nomad","slug":"first-index-mismatch-source-d-destination-d","errorCode":null,"errorMessage":"first index mismatch: source=%d, destination=%d","messagePattern":"first index mismatch: source=(.+?), destination=(.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"helper/raftutil/migrate.go","lineNumber":273,"sourceCode":"\t}\n\n\tsrcLast, err := src.LastIndex()\n\tif err != nil {\n\t\treturn fmt.Errorf(\"failed to get source last index: %w\", err)\n\t}\n\n\tdstFirst, err := dst.FirstIndex()\n\tif err != nil {\n\t\treturn fmt.Errorf(\"failed to get destination first index: %w\", err)\n\t}\n\n\tdstLast, err := dst.LastIndex()\n\tif err != nil {\n\t\treturn fmt.Errorf(\"failed to get destination last index: %w\", err)\n\t}\n\n\tif srcFirst != dstFirst {\n\t\treturn fmt.Errorf(\"first index mismatch: source=%d, destination=%d\", srcFirst, dstFirst)\n\t}\n\n\tif srcLast != dstLast {\n\t\treturn fmt.Errorf(\"last index mismatch: source=%d, destination=%d\", srcLast, dstLast)\n\t}\n\n\t// Verify stable store uint64 keys.\n\tuint64Keys := []string{\"CurrentTerm\", \"LastVoteTerm\"}\n\tfor _, key := range uint64Keys {\n\t\tsrcVal, err := src.GetUint64([]byte(key))\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"failed to get source uint64 key %s: %w\", key, err)\n\t\t}\n\n\t\tdstVal, err := dst.GetUint64([]byte(key))\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"failed to get destination uint64 key %s: %w\", key, err)\n\t\t}","sourceCodeStart":255,"sourceCodeEnd":291,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/helper/raftutil/migrate.go#L255-L291","documentation":"Fires in verifyMigration when the source and destination raft logs disagree on FirstIndex: the WAL copy is missing or contains extra leading entries, i.e. the migration is not faithful and must not be trusted.","triggerScenarios":"Thrown at helper/raftutil/migrate.go:273 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Remove the WAL directory and re-run nomad server migrate from the intact BoltDB store","Do not start the server on a mismatched store; restore from the BoltDB backup instead","Report persistent mismatches as a bug with the raft store versions in use"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}