若依框架Invalid bound statement (not found): com.ruoyi.system.mapper.UsersMapper.selectUsersList

解决方案
当遇到 Invalid bound statement (not found) 错误时，通常表明 MyBatis 未能正确找到指定的 SQL 映射语句。以下是针对该错误的具体解决方案：
1. 检查 Mapper 接口与 XML 文件的绑定关系
确保 UsersMapper 接口与其对应的 XML 配置文件已正确定义并关联。MyBatis 的工作原理依赖于接口和 XML 文件之间的匹配，如果两者不一致，则会抛出此异常[^3]。

接口路径: 确认 com.ruoyi.system.mapper.UsersMapper 路径下的 selectUsersList 方法是否存在。
XML 命名空间 (namespace): 在 XML 文件中，确认 <mapper> 标签的 namespace 属性是否设置为 com.ruoyi.system.mapper.UsersMapper[^4]。

<mapper namespace="com.ruoyi.system.mapper.UsersMapper">
</mapper>
登录后复制
2. 检查方法名称一致性
验证 selectUsersList 方法在 Java 接口中定义的方法签名以及 XML 中的 <select> 或其他标签的 id 是否完全一致。任何拼写差异都会导致找不到映射语句的问题[^2]。

Java 接口:

public interface UsersMapper {
List<User> selectUsersList(Map<String, Object> params);
}
登录后复制

XML 定义:

<select id="selectUsersList" resultType="com.ruoyi.system.domain.User">
SELECT * FROM users WHERE status = #{status}
</select>
登录后复制
3. 检查 XML 文件的位置和加载情况
确保 XML 文件位于项目的正确目录下，并被 Spring Boot 自动扫描到。默认情况下，Spring Boot 会在 resources/mappers/ 下查找 XML 文件。

如果使用的是基于注解的方式（如 @MapperScan），需确认配置类中指定了正确的包路径。

@MapperScan("com.ruoyi.system.mapper")
@SpringBootApplication
public class RuoYiApplication {
public static void main(String[] args) {
SpringApplication.run(RuoYiApplication.class, args);
}
}
登录后复制
4. 检查 resultType 和返回类型的匹配性
确认 XML 文件中的 resultType 或 resultMap 设置是否与实际返回的对象类型相匹配。如果不匹配，可能会引发运行时错误或隐含问题。

示例:

<resultMap id="userResultMap" type="com.ruoyi.system.domain.User">
<id property="userId" column="user_id"/>
<result property="username" column="username"/>
</resultMap>

<select id="selectUsersList" resultMap="userResultMap">
SELECT user_id, username FROM users
</select>
登录后复制
5. 清理缓存并重新部署项目
有时 IDE 缓存可能导致资源未及时更新至目标环境中。建议清理项目构建缓存后重新启动应用。
mvn clean install
登录后复制

总结
通过以上步骤逐一排查，可以有效定位并解决 Invalid bound statement (not found) 异常。核心在于确保 Mapper 接口、XML 文件及其内部定义的一致性和正确性。
def check_mybatis_binding():
"""
A function to simulate checking the binding between mapper and xml.
This is a conceptual example only.
"""
mapper_path = "com.ruoyi.system.mapper.UsersMapper"
method_name = "selectUsersList"

if validate_interface(mapper_path, method_name) and \
validate_xml_namespace(mapper_path) and \
validate_method_consistency(method_name):
return True
else:
return False

def validate_interface(path, name):
"""Validate if the method exists in the given path."""
pass

def validate_xml_namespace(namespace):
"""Check if the XML file has correct namespace."""
pass

def validate_method_consistency(name):
"""Ensure method ID matches with XML definition."""
pass
登录后复制