apache/hadoop · error · RuntimeException

Failed to increment token sequence number in SQL secret mana

Error message

Failed to increment token sequence number in SQL secret manager

What it means

Error "Failed to increment token sequence number in SQL secret manager" thrown in apache/hadoop.

Source

Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/security/token/delegation/SQLDelegationTokenSecretManager.java:319

  /**
   * Obtains the next available sequence number that can be allocated to a Token.
   * Sequence numbers need to be reserved using the shared sequenceNumberCounter once
   * the local batch has been exhausted, which handles sequenceNumber allocation
   * concurrently with other secret managers.
   * This method ensures that sequence numbers are incremental in a single secret manager,
   * but not across secret managers.
   * @return Next available sequence number.
   */
  @Override
  public synchronized int incrementDelegationTokenSeqNum() {
    if (currentSeqNum >= currentMaxSeqNum) {
      try {
        // Request a new batch of sequence numbers and use the
        // lowest one available.
        currentSeqNum = incrementSequenceNum(seqNumBatchSize);
        currentMaxSeqNum = currentSeqNum + seqNumBatchSize;
      } catch (SQLException e) {
        throw new RuntimeException(
            "Failed to increment token sequence number in SQL secret manager", e);
      }
    }

    return ++currentSeqNum;
  }

  /**
   * Persists a DelegationKey into the SQL database. The delegation keyId
   * is expected to be unique and any duplicate key attempts will result
   * in an IOException.
   * @param key DelegationKey to persist into the SQL database.
   */
  @Override
  protected void storeDelegationKey(DelegationKey key) throws IOException {
    try (ByteArrayOutputStream bos = new ByteArrayOutputStream();
        DataOutputStream dos = new DataOutputStream(bos)) {
      key.write(dos);

View on GitHub (pinned to 2add963021)

Solutions

1. Incrementing the token sequence number in the SQL store failed. Check for concurrent writers, deadlocks, or connection loss; see the chained SQLException.

When it happens

Trigger: Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/security/token/delegation/SQLDelegationTokenSecretManager.java:319 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/208e5f15b6997cb2. Report an issue: GitHub.