mybatis/mybatis-3 · error · BuilderException

Cannot resolve the provider method because '{methodName}' no

Error message

Cannot resolve the provider method because '{methodName}' not found in SqlProvider '{className}'.

What it means

Error "Cannot resolve the provider method because '{methodName}' not found in SqlProvider '{className}'." thrown in mybatis/mybatis-3.

Source

Thrown at src/main/java/org/apache/ibatis/builder/annotation/ProviderMethodResolver.java:59

   * <ul>
   * <li>Method name matches with mapper method</li>
   * <li>Return type matches the {@link CharSequence}({@link String}, {@link StringBuilder}, etc...)</li>
   * </ul>
   * If matched method is zero or multiple, it throws a {@link BuilderException}.
   *
   * @param context
   *          a context for SQL provider
   *
   * @return an SQL provider method
   *
   * @throws BuilderException
   *           Throws when cannot resolve a target method
   */
  default Method resolveMethod(ProviderContext context) {
    List<Method> sameNameMethods = Arrays.stream(getClass().getMethods())
        .filter(m -> m.getName().equals(context.getMapperMethod().getName())).collect(Collectors.toList());
    if (sameNameMethods.isEmpty()) {
      throw new BuilderException("Cannot resolve the provider method because '" + context.getMapperMethod().getName()
          + "' not found in SqlProvider '" + getClass().getName() + "'.");
    }
    List<Method> targetMethods = sameNameMethods.stream()
        .filter(m -> CharSequence.class.isAssignableFrom(m.getReturnType())).collect(Collectors.toList());
    if (targetMethods.size() == 1) {
      return targetMethods.get(0);
    }
    if (targetMethods.isEmpty()) {
      throw new BuilderException("Cannot resolve the provider method because '" + context.getMapperMethod().getName()
          + "' does not return the CharSequence or its subclass in SqlProvider '" + getClass().getName() + "'.");
    }
    throw new BuilderException("Cannot resolve the provider method because '" + context.getMapperMethod().getName()
        + "' is found multiple in SqlProvider '" + getClass().getName() + "'.");
  }

}

View on GitHub (pinned to 008069adb1)

Solutions

1. Add a method with the reported name to the SqlProvider class, or correct the method name in the @SelectProvider/@InsertProvider/etc. annotation.
2. If relying on the default provider method resolution, name the provider method exactly like the mapper method.
3. Check for typos and case mismatches between the annotation's method attribute and the provider class method.

When it happens

Trigger: Thrown at src/main/java/org/apache/ibatis/builder/annotation/ProviderMethodResolver.java:59 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of mybatis/mybatis-3@008069adb1 (2026-08-14). Data as JSON: /api/errors/1ed7131252a4fb93. Report an issue: GitHub.