{"record":{"id":"5bce1a8cf39bcbab","repo":"Tencent/WeKnora","slug":"chunk-s-not-found-w","errorCode":null,"errorMessage":"chunk %s not found: %w","messagePattern":"chunk (.+?) not found: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/agent/tools/scope_authorization.go","lineNumber":117,"sourceCode":"\tctx context.Context,\n\tsearchTargets types.SearchTargets,\n\tchunkID string,\n\tchunkService interfaces.ChunkService,\n\tknowledgeService interfaces.KnowledgeService,\n) (*types.Chunk, error) {\n\tchunkID = strings.TrimSpace(chunkID)\n\tif chunkID == \"\" {\n\t\treturn nil, fmt.Errorf(\"chunk_id is required\")\n\t}\n\tif chunkService == nil {\n\t\treturn nil, fmt.Errorf(\"chunk service is unavailable\")\n\t}\n\tchunk, err := chunkService.GetChunkByIDOnly(ctx, chunkID)\n\tif err != nil || chunk == nil {\n\t\tif err == nil {\n\t\t\terr = fmt.Errorf(\"empty result\")\n\t\t}\n\t\treturn nil, fmt.Errorf(\"chunk %s not found: %w\", chunkID, err)\n\t}\n\tif !chunk.IsEnabled {\n\t\treturn nil, fmt.Errorf(\"chunk %s is disabled\", chunk.ID)\n\t}\n\tif !searchTargets.ContainsKB(chunk.KnowledgeBaseID) {\n\t\treturn nil, fmt.Errorf(\"knowledge base %s is not within the current Agent scope\", chunk.KnowledgeBaseID)\n\t}\n\tallowed, err := searchTargetsAllowKnowledgeID(\n\t\tctx, searchTargets, chunk.KnowledgeID, chunk.KnowledgeBaseID, knowledgeService,\n\t)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"failed to validate chunk scope: %w\", err)\n\t}\n\tif !allowed {\n\t\treturn nil, fmt.Errorf(\"chunk %s is not within the current @mention scope\", chunk.ID)\n\t}\n\treturn chunk, nil\n}","sourceCodeStart":99,"sourceCodeEnd":135,"githubUrl":"https://github.com/Tencent/WeKnora/blob/988cbb03305e055d8ebb7d46d9ac6cc0803cd074/internal/agent/tools/scope_authorization.go#L99-L135","documentation":"Chunk authorization lookup failed: GetChunkByIDOnly returned an error or an empty result (inner 'empty result' sentinel if nil,nil), so the chunk cannot be resolved for scope checks and access is denied with a not-found error.","triggerScenarios":"Thrown at internal/agent/tools/scope_authorization.go:117 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Confirm the chunk ID exists","Check chunk service/storage health for the inner error","Handle uniformly as not-found to avoid leaking existence"],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"988cbb03305e055d8ebb7d46d9ac6cc0803cd074","analyzedAt":"2026-09-02T14:41:08.344Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}