{"id":14014,"date":"2024-03-15T08:19:10","date_gmt":"2024-03-15T08:19:10","guid":{"rendered":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/"},"modified":"2025-08-06T02:23:27","modified_gmt":"2025-08-06T02:23:27","slug":"how-to-configure-the-mapper-scanning-path-in-mybatis","status":"publish","type":"post","link":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/","title":{"rendered":"MyBatis Mapper Scan Path Guide"},"content":{"rendered":"

In MyBatis, you can specify the scan path for Mapper interfaces through a configuration file. The specific configuration method is as follows:<\/p>\n

    \n
  1. the XML file for mybatis configuration<\/li>\n
  2. cartographers<\/li>\n<\/ol>\n
    <configuration<\/span>><\/span>\r\n    <!-- \u5176\u4ed6\u914d\u7f6e --><\/span>\r\n    \r\n    <mappers<\/span>><\/span>\r\n        <!-- \u914d\u7f6e Mapper \u63a5\u53e3\u7684\u626b\u63cf\u8def\u5f84 --><\/span>\r\n        <package<\/span> name<\/span>=\"com.example.mapper\"<\/span> \/><\/span>\r\n    <\/mappers<\/span>><\/span>\r\n<\/configuration<\/span>><\/span>\r\n<\/code><\/pre>\n
      \n
    1. In the  tag, use the name attribute to specify the package path where the Mapper interface is located. Wildcard * can be used to match multiple package paths. For example, if the Mapper interface is in the com.example.mapper package, it can be configured as .<\/li>\n
    2. Please note that MyBatis will by default scan XML configuration files with the same name as the Mapper interface, automatically binding them together. So, make sure that the Mapper interface and its corresponding XML configuration file have the same name, and are in the same package path.<\/li>\n<\/ol>\n
      In this way, when MyBatis is started, it will automatically scan the specified Mapper interface path and register it in MyBatis configuration for later use.<\/p>\n","protected":false},"excerpt":{"rendered":"
      In MyBatis, you can specify the scan path for Mapper interfaces through a configuration file. The specific configuration method is as follows: the XML file for mybatis configuration cartographers <configuration> <!– \u5176\u4ed6\u914d\u7f6e –> <mappers> <!– \u914d\u7f6e Mapper \u63a5\u53e3\u7684\u626b\u63cf\u8def\u5f84 –> <package name=”com.example.mapper” \/> <\/mappers> <\/configuration> In the tag, use the name attribute to specify the package […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[1],"tags":[2797,18864,2689,2742,14269],"class_list":["post-14014","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-java-orm","tag-mapper-scanning","tag-mybatis-configuration","tag-mybatis-tutorial","tag-xml-configuration"],"yoast_head":"\nMyBatis Mapper Scan Path Guide - Blog - Silicon Cloud<\/title>\n<meta name=\"description\" content=\"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MyBatis Mapper Scan Path Guide\" \/>\n<meta property=\"og:description\" content=\"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog - Silicon Cloud\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-03-15T08:19:10+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-06T02:23:27+00:00\" \/>\n<meta name=\"author\" content=\"Emily Johnson\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:site\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Emily Johnson\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\"},\"author\":{\"name\":\"Emily Johnson\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/3b041b19cffc258705478ecfab895378\"},\"headline\":\"MyBatis Mapper Scan Path Guide\",\"datePublished\":\"2024-03-15T08:19:10+00:00\",\"dateModified\":\"2025-08-06T02:23:27+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\"},\"wordCount\":151,\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"keywords\":[\"Java ORM\",\"Mapper scanning\",\"MyBatis configuration\",\"MyBatis tutorial\",\"XML configuration\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\",\"name\":\"MyBatis Mapper Scan Path Guide - Blog - Silicon Cloud\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\"},\"datePublished\":\"2024-03-15T08:19:10+00:00\",\"dateModified\":\"2025-08-06T02:23:27+00:00\",\"description\":\"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.silicloud.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MyBatis Mapper Scan Path Guide\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"name\":\"Silicon Cloud Blog\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\",\"name\":\"Silicon Cloud Blog\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"contentUrl\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"width\":1024,\"height\":1024,\"caption\":\"Silicon Cloud Blog\"},\"image\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\",\"https:\/\/twitter.com\/SiliCloudGlobal\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/3b041b19cffc258705478ecfab895378\",\"name\":\"Emily Johnson\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/a5cb4e73d02ab1d79f2dfe919389ff7c1de072baa97686392031c03d858cc358?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/a5cb4e73d02ab1d79f2dfe919389ff7c1de072baa97686392031c03d858cc358?s=96&d=mm&r=g\",\"caption\":\"Emily Johnson\"},\"url\":\"https:\/\/www.silicloud.com\/blog\/author\/emilyjohnson\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"MyBatis Mapper Scan Path Guide - Blog - Silicon Cloud","description":"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/","og_locale":"en_US","og_type":"article","og_title":"MyBatis Mapper Scan Path Guide","og_description":"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.","og_url":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/","og_site_name":"Blog - Silicon Cloud","article_publisher":"https:\/\/www.facebook.com\/SiliCloudGlobal\/","article_published_time":"2024-03-15T08:19:10+00:00","article_modified_time":"2025-08-06T02:23:27+00:00","author":"Emily Johnson","twitter_card":"summary_large_image","twitter_creator":"@SiliCloudGlobal","twitter_site":"@SiliCloudGlobal","twitter_misc":{"Written by":"Emily Johnson","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#article","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/"},"author":{"name":"Emily Johnson","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/3b041b19cffc258705478ecfab895378"},"headline":"MyBatis Mapper Scan Path Guide","datePublished":"2024-03-15T08:19:10+00:00","dateModified":"2025-08-06T02:23:27+00:00","mainEntityOfPage":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/"},"wordCount":151,"publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"keywords":["Java ORM","Mapper scanning","MyBatis configuration","MyBatis tutorial","XML configuration"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/","url":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/","name":"MyBatis Mapper Scan Path Guide - Blog - Silicon Cloud","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/#website"},"datePublished":"2024-03-15T08:19:10+00:00","dateModified":"2025-08-06T02:23:27+00:00","description":"Learn how to configure MyBatis mapper scanning paths in XML. Step-by-step guide for proper mapper setup.","breadcrumb":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-the-mapper-scanning-path-in-mybatis\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.silicloud.com\/blog\/"},{"@type":"ListItem","position":2,"name":"MyBatis Mapper Scan Path Guide"}]},{"@type":"WebSite","@id":"https:\/\/www.silicloud.com\/blog\/#website","url":"https:\/\/www.silicloud.com\/blog\/","name":"Silicon Cloud Blog","description":"","publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.silicloud.com\/blog\/#organization","name":"Silicon Cloud Blog","url":"https:\/\/www.silicloud.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","contentUrl":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","width":1024,"height":1024,"caption":"Silicon Cloud Blog"},"image":{"@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/SiliCloudGlobal\/","https:\/\/twitter.com\/SiliCloudGlobal"]},{"@type":"Person","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/3b041b19cffc258705478ecfab895378","name":"Emily Johnson","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/a5cb4e73d02ab1d79f2dfe919389ff7c1de072baa97686392031c03d858cc358?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/a5cb4e73d02ab1d79f2dfe919389ff7c1de072baa97686392031c03d858cc358?s=96&d=mm&r=g","caption":"Emily Johnson"},"url":"https:\/\/www.silicloud.com\/blog\/author\/emilyjohnson\/"}]}},"_links":{"self":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/14014","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/comments?post=14014"}],"version-history":[{"count":2,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/14014\/revisions"}],"predecessor-version":[{"id":158024,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/14014\/revisions\/158024"}],"wp:attachment":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/media?parent=14014"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/categories?post=14014"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/tags?post=14014"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}