mybatis 的官方变更里不只有代码层面的修补，也包含文档交付方式的调整。根据官方 3.5.15 发布说明，项目已经迁移到 maven site 4.0.0，并使用 site xsd 2.0.0；同时，官方明确表示 pdf 文档已关闭，当前应以站内页面作为阅读入口。这个变化看起来不像版本功能更新那样显眼，但对企业内训、文档归档和开发者检索路径的影响并不小。以前习惯打包 pdf 给团队内部转发的人，之后需要改成直接引用官网页面，否则容易在二次传播时继续使用过期副本。
来源：mybatis/mybatis-3 3.5.15 发布页
为什么这件事值得单独写成资讯，而不是在版本文章里一笔带过？原因在于它改变了官方知识的主要分发渠道。MyBatis 本来就高度依赖配置、映射和 API 细节，一旦文档入口从离线 PDF 转向持续更新的站内页面，团队里关于配置项、动态 SQL、映射行为和 Java API 的核验动作，也应该同步回到官网。否则，文档截图、离线包和历史导出的 PDF 很容易落后于正式说明，尤其在设置项默认值、构造器映射、日志行为和插件调用方式这些细节上，老资料最容易制造误判。
来源：MyBatis Java API 页面
从实际使用角度看，这条公告也给出了一种工作方法上的提醒：MyBatis 的后续查证应优先回到官网页面和主仓库发布记录，而不是把旧 PDF 当成静态权威。对正在做框架升级、数据库抽象层重构或新人培训的团队来说，这会影响知识库维护方式、内部链接整理方式，甚至影响代码评审时引用哪份官方文档。官方已经把“请先使用 site pages”写明，继续依赖旧 PDF，更大的问题不是格式落后，而是可能把不再更新的文档副本继续当成当前规范来执行。
信源说明：依据 MyBatis 3.5.15 官方发布说明与 MyBatis Java API 文档页整理；文档分发方式与站点入口以官网当前页面为准。
