{"record":{"id":"6d63c7db216c61d0","repo":"apache/hadoop","slug":"outstanding-satisfier-queue-limit-exceeded-tr","errorCode":null,"errorMessage":"Outstanding satisfier queue limit: {} exceeded, try later!","messagePattern":"Outstanding satisfier queue limit: (.+?) exceeded, try later!","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/sps/StoragePolicySatisfyManager.java","lineNumber":236,"sourceCode":"   *         storages.\n   */\n  public Long getNextPathId() {\n    synchronized (pathsToBeTraversed) {\n      return pathsToBeTraversed.poll();\n    }\n  }\n\n  /**\n   * Verify that satisfier queue limit exceeds allowed outstanding limit.\n   * @throws IOException\n   */\n  public void verifyOutstandingPathQLimit() throws IOException {\n    long size = pathsToBeTraversed.size();\n    // Checking that the SPS call Q exceeds the allowed limit.\n    if (outstandingPathsLimit - size <= 0) {\n      LOG.debug(\"Satisifer Q - outstanding limit:{}, current size:{}\",\n          outstandingPathsLimit, size);\n      throw new IOException(\"Outstanding satisfier queue limit: \"\n          + outstandingPathsLimit + \" exceeded, try later!\");\n    }\n  }\n\n  /**\n   * Removes the SPS path id from the list of sps paths.\n   *\n   * @throws IOException\n   */\n  private void clearPathIds(){\n    synchronized (pathsToBeTraversed) {\n      Iterator<Long> iterator = pathsToBeTraversed.iterator();\n      while (iterator.hasNext()) {\n        Long trackId = iterator.next();\n        try {\n          namesystem.removeXattr(trackId,\n              HdfsServerConstants.XATTR_SATISFY_STORAGE_POLICY);\n        } catch (IOException e) {","sourceCodeStart":218,"sourceCodeEnd":254,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/sps/StoragePolicySatisfyManager.java#L218-L254","documentation":"Error \"Outstanding satisfier queue limit: {} exceeded, try later!\" thrown in apache/hadoop.","triggerScenarios":"A satisfyStoragePolicy request arrives when the SPS outstanding work queue is at its limit.","commonSituations":"Batch tools flooding the NameNode with storage policy satisfaction requests.","solutions":["Retry later after outstanding storage policy satisfier work drains, or raise dfs.storage.policy.satisfier.queue.limit if load is legitimate."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-23T01:17:44.959Z"}