Mismatched return type

Reports method and block return values whose inferred types don't match the method's expected return type. The expected return type is taken from any of:

The RBS type signature
The Sorbet type signature
The YARD @return tag

Example:

# @return [Integer]
def method
  1.0
end

Locating this inspection

By ID

Can be used to locate inspection in e.g. Qodana configuration files, where you can quickly enable or disable it, or adjust its settings.

RubyMismatchedReturnType

Via Settings dialog

Path to the inspection settings via IntelliJ Platform IDE Settings dialog, when you need to adjust inspection settings directly from your IDE.

Settings or Preferences | Editor | Inspections | Ruby | Probable bugs

Inspection ID: RubyMismatchedReturnType

Inspection options

Here you can find the description of settings available for the Mismatched return type inspection, and the reference of their default values.

Check types from RBS

Option ID:

RubyExpectedTypeProvider.RbsRubyExpectedReturnTypeProvider

Default value:

Selected

Check types from Sorbet

Option ID:

RubyExpectedTypeProvider.RubySorbetExpectedReturnTypeProvider

Default value:

Selected

Check types from YARD

Option ID:

RubyExpectedTypeProvider.RubyYardExpectedReturnTypeProvider

Default value:

Selected

Check nilability

Option ID:

myCheckNilability

Default value:

Selected

Suppressing Inspection

You can suppress this inspection by placing the following comment marker before the code fragment where you no longer want messages from this inspection to appear:

//noinspection RubyMismatchedReturnType

More detailed instructions as well as other ways and options that you have can be found in the product documentation:

RubyMine 2025.2

Inspection Details
By default bundled with:	Qodana for Ruby 2025.2, RubyMine 2025.2,

Last modified: 18 September 2025