Watch Expressions in the Java Debugger

Direct Answer

A watch expression is a Java expression that the debugger evaluates in the selected stack frame whenever execution is paused. It is useful for tracking a derived value such as order.getItems().size() while stepping through code. Keep watches small and side-effect free: method calls may run application code, change state, throw an exception, or make debugging slow.

Code Example

@Service
public class OrderProcessor {
    private final DiscountCalculator discountCalculator;
    private final TaxCalculator taxCalculator;

    public Invoice processOrder(Order order) {
        // Add watch: order.getItems().size()
        var subtotal = order.getItems().stream()
            .mapToDouble(Item::getPrice)
            .sum();
        // Add watch: subtotal
        
        var discount = discountCalculator.calculate(order);
        // Add watch: discount / subtotal * 100 (discount percentage)
        
        var discountedTotal = subtotal - discount;
        var tax = taxCalculator.calculate(discountedTotal);
        // Add watch: discountedTotal + tax
        
        return new Invoice(order.getId(), subtotal, discount, tax);
    }
}

Common Mistakes & Pitfalls

• Expecting live updates while code runs: watches are normally evaluated when the debugger has paused.
• Calling code with side effects: a watch such as list.remove(0) changes the program being investigated.
• Using expensive expressions: large stream operations or blocking calls can make each pause slow or alter timing.
• Ignoring the selected frame: local variables from another frame are out of scope.
• Keeping stale watches: remove expressions that no longer apply to the current problem.