Debug Session Does Not Break at Breakpoint When Assigned in batch.execute Method

[PieterJacob]

Summary

Whenever you start a debug session using the replay debugger, the session does not stop at any breakpoint when placed inside a batch execute method.

Steps To Reproduce:

For example...

1. Create a unit test that executes a batch. Make sure that the execute method has some code.
2. Create a log file of the transaction executed in step1.
3. Put a breakpoint somewhere in the execute method of the batch.
4. Start a debug session based on the .log file choosing SFDX: Launch Apex Replay Debugger with Selected File
5. Verify that the debug session does not stop at the breakpoint.

If the execute method contains a call to a class method and a breakpoint is placed there, the debug session does stop there.

Expected result

1. The debug session should stop at the breakpoint in the execute method.

Actual result

The Debug session does not stop and automatically ends.

Salesforce Extension Version in VS Code:

Salesforce CLI Version:
@salesforce/cli/2.131.7 darwin-arm64 node-v22.22.2

OS and version:
macOS Tahoe 26.3 (25D125)
VS Code version:
1.118.1 (Universal)
Most recent version of the extensions where this was working:
I don't remember if this ever worked. I have used Windows before, and there I have also noticed the same behaviour.

[svc-idee-bot]

Thank you for filing this issue. We appreciate your feedback and will review the issue as soon as possible. Remember, however, that GitHub isn't a mechanism for receiving support under any agreement or SLA. If you require immediate assistance, contact Salesforce Customer Support.

[peternhale]

@PieterJacob I was able to set a breakpoint inside the execute method and when I ran the related test that breakpoint was visited.

public class AccountBatchUpdate implements Database.Batchable<SObject> {

    public Database.QueryLocator start(Database.BatchableContext bc) {
        return Database.getQueryLocator('SELECT Id, Name FROM Account WHERE Industry = null');
    }

    public void execute(Database.BatchableContext bc, List<SObject> scope) {
        List<Account> accounts = (List<Account>) scope;
        for (Account acc : accounts) {
            acc.Industry = 'Other';
        }
        update accounts;
    }

    public void finish(Database.BatchableContext bc) {
        System.debug('Batch complete. Processed all accounts with null Industry.');
    }
}

@IsTest
private class AccountBatchUpdateTest {

    @IsTest
    static void testBatchExecution() {
        List<Account> accounts = new List<Account>();
        for (Integer i = 0; i < 5; i++) {
            accounts.add(new Account(Name = 'Test ' + i));
        }
        insert accounts;

        Test.startTest();
        Database.executeBatch(new AccountBatchUpdate(), 200);
        Test.stopTest();

        List<Account> updated = [SELECT Industry FROM Account];
        for (Account acc : updated) {
            System.assertEquals('Other', acc.Industry);
        }
    }
}

Did you setup tracing for you org's user?