fix(db): resolve resource leakage in database close()

chainbase/src/main/java/org/tron/core/db/TronDatabase.java

@@ -76,13 +76,23 @@ public void reset() {
   @Override
   public void close() {
     logger.info("******** Begin to close {}. ********", getName());
+    try {
+      doClose();
+    } finally {
+      logger.info("******** End to close {}. ********", getName());
+    }
+  }
+
+  protected void doClose() {
     try {
       writeOptions.close();
+    } catch (Exception e) {
+      logger.warn("Failed to close writeOptions in {}.", getName(), e);
+    }
+    try {
       dbSource.closeDB();
     } catch (Exception e) {
-      logger.warn("Failed to close {}.", getName(), e);
-    } finally {
-      logger.info("******** End to close {}. ********", getName());
+      logger.warn("Failed to close dbSource in {}.", getName(), e);
     }
   }
 

chainbase/src/main/java/org/tron/core/store/CheckPointV2Store.java

@@ -62,17 +62,16 @@ public void updateByBatch(Map<byte[], byte[]> rows) {
     this.dbSource.updateByBatch(rows, writeOptions);
   }
 
-  /**
-   * close the database.
-   */
   @Override
   public void close() {
     logger.debug("******** Begin to close {}. ********", getName());
     try {
       writeOptions.close();
-      dbSource.closeDB();
     } catch (Exception e) {
-      logger.warn("Failed to close {}.", getName(), e);
+      logger.warn("Failed to close writeOptions in {}.", getName(), e);
+    }
+    try {
+      doClose();
     } finally {
       logger.debug("******** End to close {}. ********", getName());
     }

framework/src/test/java/org/tron/common/logsfilter/FilterQueryTest.java

@@ -17,6 +17,7 @@
 import java.util.List;
 import java.util.Map;
 import lombok.extern.slf4j.Slf4j;
+import org.junit.After;
 import org.junit.Assert;
 import org.junit.Test;
 import org.tron.common.logsfilter.capsule.ContractEventTriggerCapsule;
@@ -28,6 +29,11 @@
 @Slf4j
 public class FilterQueryTest {
 
+  @After
+  public void tearDown() {
+    EventPluginLoader.getInstance().setFilterQuery(null);
+  }
+
   @Test
   public synchronized void testParseFilterQueryBlockNumber() {
     assertEquals(LATEST_BLOCK_NUM, parseToBlockNumber(EMPTY));

framework/src/test/java/org/tron/core/db/CheckPointV2StoreTest.java

@@ -0,0 +1,161 @@
+package org.tron.core.db;
+
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.spy;
+import static org.mockito.Mockito.verify;
+
+import java.io.IOException;
+import java.lang.reflect.Field;
+import org.junit.AfterClass;
+import org.junit.Assert;
+import org.junit.BeforeClass;
+import org.junit.ClassRule;
+import org.junit.Test;
+import org.junit.rules.TemporaryFolder;
+import org.rocksdb.RocksDB;
+import org.tron.common.TestConstants;
+import org.tron.common.storage.WriteOptionsWrapper;
+import org.tron.core.config.args.Args;
+import org.tron.core.db.common.DbSourceInter;
+import org.tron.core.store.CheckPointV2Store;
+
+public class CheckPointV2StoreTest {
+
+  @ClassRule
+  public static final TemporaryFolder temporaryFolder = new TemporaryFolder();
+
+  static {
+    RocksDB.loadLibrary();
+  }
+
+  @BeforeClass
+  public static void initArgs() throws IOException {
+    Args.setParam(
+        new String[]{"-d", temporaryFolder.newFolder().toString()},
+        TestConstants.TEST_CONF
+    );
+  }
+
+  @AfterClass
+  public static void destroy() {
+    Args.clearParam();
+  }
+
+  @Test
+  public void testStubMethods() throws Exception {
+    CheckPointV2Store store = new CheckPointV2Store("test-stubs");
+    try {
+      byte[] key = "key".getBytes();
+
+      store.put(key, new byte[]{});
+      Assert.assertNull(store.get(key));
+      Assert.assertFalse(store.has(key));
+      store.forEach(item -> {
+      });
+      Assert.assertNull(store.spliterator());
+
+      Field dbSourceField = TronDatabase.class.getDeclaredField("dbSource");
+      dbSourceField.setAccessible(true);
+      DbSourceInter<byte[]> originalDbSource =
+          (DbSourceInter<byte[]>) dbSourceField.get(store);
+      DbSourceInter<byte[]> mockDbSource = mock(DbSourceInter.class);
+      dbSourceField.set(store, mockDbSource);
+      store.delete(key);
+      dbSourceField.set(store, originalDbSource);
+
+      java.lang.reflect.Method initMethod =
+          CheckPointV2Store.class.getDeclaredMethod("init");
+      initMethod.setAccessible(true);
+      initMethod.invoke(store);
+    } finally {
+      store.close();
+    }
+  }
+
+  @Test
+  public void testCloseWithRealResources() {
+    CheckPointV2Store store = new CheckPointV2Store("test-close-real");
+    // Exercises the real writeOptions.close() and dbSource.closeDB() code paths
+    store.close();
+  }
+
+  @Test
+  public void testCloseReleasesAllResources() throws Exception {
+    CheckPointV2Store store = new CheckPointV2Store("test-close");
+
+    // Replace dbSource with a mock so we can verify closeDB()
+    Field dbSourceField = TronDatabase.class.getDeclaredField("dbSource");
+    dbSourceField.setAccessible(true);
+    DbSourceInter<byte[]> originalDbSource = (DbSourceInter<byte[]>) dbSourceField.get(store);
+    DbSourceInter<byte[]> mockDbSource = mock(DbSourceInter.class);
+    dbSourceField.set(store, mockDbSource);
+
+    try {
+      store.close();
+
+      verify(mockDbSource).closeDB();
+    } finally {
+      originalDbSource.closeDB();
+    }
+  }
+
+  @Test
+  public void testCloseWhenDbSourceThrows() throws Exception {
+    CheckPointV2Store store = new CheckPointV2Store("test-close-dbsource-throws");
+
+    Field dbSourceField = TronDatabase.class.getDeclaredField("dbSource");
+    dbSourceField.setAccessible(true);
+    DbSourceInter<byte[]> originalDbSource = (DbSourceInter<byte[]>) dbSourceField.get(store);
+    DbSourceInter<byte[]> mockDbSource = mock(DbSourceInter.class);
+    doThrow(new RuntimeException("simulated dbSource failure")).when(mockDbSource).closeDB();
+    dbSourceField.set(store, mockDbSource);
+
+    try {
+      store.close();
+    } finally {
+      originalDbSource.closeDB();
+    }
+  }
+
+  @Test
+  public void testCloseDbSourceWhenWriteOptionsThrows() throws Exception {
+    CheckPointV2Store store = new CheckPointV2Store("test-close-exception");
+
+    // Replace child writeOptions with a spy that throws on close
+    Field childWriteOptionsField = CheckPointV2Store.class.getDeclaredField("writeOptions");
+    childWriteOptionsField.setAccessible(true);
+    WriteOptionsWrapper childWriteOptions =
+        (WriteOptionsWrapper) childWriteOptionsField.get(store);
+    WriteOptionsWrapper spyChildWriteOptions = spy(childWriteOptions);
+    doThrow(new RuntimeException("simulated writeOptions failure"))
+        .when(spyChildWriteOptions).close();
+    childWriteOptionsField.set(store, spyChildWriteOptions);
+
+    // Replace parent writeOptions with a spy that throws on close
+    Field parentWriteOptionsField = TronDatabase.class.getDeclaredField("writeOptions");
+    parentWriteOptionsField.setAccessible(true);
+    WriteOptionsWrapper parentWriteOptions =
+        (WriteOptionsWrapper) parentWriteOptionsField.get(store);
+    WriteOptionsWrapper spyParentWriteOptions = spy(parentWriteOptions);
+    doThrow(new RuntimeException("simulated parent writeOptions failure"))
+        .when(spyParentWriteOptions).close();
+    parentWriteOptionsField.set(store, spyParentWriteOptions);
+
+    // Replace dbSource with a mock
+    Field dbSourceField = TronDatabase.class.getDeclaredField("dbSource");
+    dbSourceField.setAccessible(true);
+    DbSourceInter<byte[]> originalDbSource = (DbSourceInter<byte[]>) dbSourceField.get(store);
+    DbSourceInter<byte[]> mockDbSource = mock(DbSourceInter.class);
+    dbSourceField.set(store, mockDbSource);
+
+    try {
+      store.close();
+
+      // dbSource.closeDB() must be called even though both writeOptions threw
+      verify(mockDbSource).closeDB();
+    } finally {
+      originalDbSource.closeDB();
+    }
+  }
+}

framework/src/test/java/org/tron/core/db/TronDatabaseTest.java

@@ -1,7 +1,13 @@
 package org.tron.core.db;
 
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.spy;
+import static org.mockito.Mockito.verify;
+
 import com.google.protobuf.InvalidProtocolBufferException;
 import java.io.IOException;
+import java.lang.reflect.Field;
 import org.junit.AfterClass;
 import org.junit.Assert;
 import org.junit.BeforeClass;
@@ -12,7 +18,9 @@
 import org.junit.rules.TemporaryFolder;
 import org.rocksdb.RocksDB;
 import org.tron.common.TestConstants;
+import org.tron.common.storage.WriteOptionsWrapper;
 import org.tron.core.config.args.Args;
+import org.tron.core.db.common.DbSourceInter;
 import org.tron.core.exception.BadItemException;
 import org.tron.core.exception.ItemNotFoundException;
 
@@ -99,4 +107,48 @@ public void TestGetFromRoot() throws
     Assert.assertEquals(db.getFromRoot("test".getBytes()),
         "test");
   }
+
+  @Test
+  public void testDoCloseDbSourceCalledWhenWriteOptionsThrows() throws Exception {
+    TronDatabase<String> db = new TronDatabase<String>("test-do-close") {
+
+      @Override
+      public void put(byte[] key, String item) {
+      }
+
+      @Override
+      public void delete(byte[] key) {
+      }
+
+      @Override
+      public String get(byte[] key) {
+        return null;
+      }
+
+      @Override
+      public boolean has(byte[] key) {
+        return false;
+      }
+    };
+
+    Field writeOptionsField = TronDatabase.class.getDeclaredField("writeOptions");
+    writeOptionsField.setAccessible(true);
+    WriteOptionsWrapper spyWriteOptions = spy((WriteOptionsWrapper) writeOptionsField.get(db));
+    doThrow(new RuntimeException("simulated writeOptions failure")).when(spyWriteOptions).close();
+    writeOptionsField.set(db, spyWriteOptions);
+
+    Field dbSourceField = TronDatabase.class.getDeclaredField("dbSource");
+    dbSourceField.setAccessible(true);
+    DbSourceInter<byte[]> originalDbSource = (DbSourceInter<byte[]>) dbSourceField.get(db);
+    DbSourceInter<byte[]> mockDbSource = mock(DbSourceInter.class);
+    dbSourceField.set(db, mockDbSource);
+
+    try {
+      db.doClose();
+      verify(spyWriteOptions).close();
+      verify(mockDbSource).closeDB();
+    } finally {
+      originalDbSource.closeDB();
+    }
+  }
 }

framework/src/test/java/org/tron/core/event/BlockEventGetTest.java

@@ -90,6 +90,7 @@ public static void init() {
 
   @Before
   public void before() throws IOException {
+    EventPluginLoader.getInstance().setFilterQuery(null);
     Args.getInstance().setNodeListenPort(10000 + port.incrementAndGet());
 
     dbManager = context.getBean(Manager.class);