Understanding Mockito’s Default Behavior: Handling Null Returns

When working with Mockito, a popular Java mocking framework, developers often encounter a scenario where Mockito defaults to using null for unstubbed calls. This behavior, while initially perplexing, is an intentional design choice aimed at promoting safe and clear testing practices. In this article, we delve into the reasons behind Mockito’s use of null and provide strategies for effectively managing this behavior in your Java tests.

Why Mockito Uses null by Default

  1. Safety and Explicitness: Mockito’s default to return null for unstubbed calls is a safety measure. It prevents the framework from making potentially incorrect assumptions, leading to clear and predictable test outcomes.
  2. Good Testing Practices: This approach encourages developers to explicitly define mock behaviors, enhancing test readability and maintainability.
  3. Avoiding Misleading Results: Automatic value guessing could lead to unexpected and misleading test results, complicating debugging efforts. The null return is a clear indicator for developers to specify intended mock behaviors.

Effective Strategies to Handle null Returns

  1. Explicit Stubbing: Define mock behaviors explicitly using when(...).thenReturn(...) to specify expected returns for method calls.
  2. Default Answers: Use Mockito’s Answer interface for generalized default return values on unstubbed calls.
  3. Customizing Mock Settings: Utilize Mockito.withSettings() to alter the default behavior of mocks created with @Mock, offering alternatives to the null return.
  4. Argument Matchers: Employ argument matchers like any() to define mock behaviors across a range of inputs, reducing reliance on default null returns.

Practical Example

Here’s a simple example demonstrating how to define explicit behavior for a mock:


Mockito’s use of null for unstubbed calls is a thoughtful design decision, encouraging better testing practices. By explicitly defining mock behaviors, tests become more transparent and maintainable. Mockito offers flexibility to customize this behavior, allowing for effective and efficient Java testing.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.