Lotus Notes客户端因data/html文件夹大量文件启动无响应问题求助

我之前帮客户处理过几乎一模一样的场景！当你把百万级的地图瓦片塞进Notes的data/html文件夹时，确实会触发客户端的高强度扫描，直接导致无响应。下面给你拆解原因和解决方案：

是什么在扫描data/html文件夹？ #

核心是Lotus Notes内置的HTTP服务和文件资源监控机制：

• Notes客户端运行XPages时，会启动内置的HTTP任务，它默认会扫描data/html目录，把里面的文件当作可访问的Web资源（比如图片、静态文件）。
• 同时，Notes的应用程序设计同步机制也会监控这个目录，试图将文件识别为应用的“文件资源”设计元素，当文件量达到百万级时，这个扫描过程会耗尽IO和CPU资源，直接卡住客户端。

开发环境没出现问题，大概率是因为：

• 开发环境的瓦片文件量远少于生产环境；
• 开发环境的Notes客户端（或Designer）默认关闭了部分自动扫描选项，或者HTTP任务不是随客户端启动就运行的。

怎么阻止扫描并解决无响应问题？ #

1. 彻底迁移瓦片文件到外部目录（最推荐） #

data/html本来就不是用来存储海量静态文件的目录，把地图瓦片移到Notes客户端安装目录之外的路径（比如C:\OfflineMapTiles\），然后在XPages里通过Java代码直接读取外部文件并输出到浏览器：

// 示例：在XPage的自定义控件中读取外部瓦片文件
File tileFile = new File("C:\\OfflineMapTiles\\zoom" + zoom + "\\x" + x + "\\y" + y + ".png");
if(tileFile.exists()){
    FacesContext.getCurrentInstance().getExternalContext().responseReset();
    FacesContext.getCurrentInstance().getExternalContext().setResponseContentType("image/png");
    OutputStream os = FacesContext.getCurrentInstance().getExternalContext().getResponseOutputStream();
    Files.copy(tileFile.toPath(), os);
    os.flush();
    FacesContext.getCurrentInstance().responseComplete();
}

这样Notes完全不会扫描这个外部目录，从根源解决问题。

2. 修改Notes.ini禁用文件资源扫描 #

如果暂时无法迁移文件，可以在Notes客户端的notes.ini文件中添加以下参数，阻止内置HTTP服务扫描data/html的文件资源：

HTTPDisableFileResourceScan=1

注意：这个参数会禁用所有data/html下的文件资源自动识别，如果你的XPages还依赖这个目录下的其他静态资源，需要单独处理这些资源的访问路径。

3. 关闭应用程序的自动同步选项 #

打开Notes客户端，找到对应的XPages应用，右键选择应用程序 -> 属性，在“高级”标签页中，取消勾选**“自动同步设计元素”和“监控文件资源变化”**相关选项，减少不必要的后台扫描。

4. 优化瓦片目录结构（辅助） #

虽然不是直接解决Notes扫描的问题，但百万级文件哪怕在Windows系统中也会导致目录访问缓慢，确保你的瓦片是按地图层级（zoom/x/y）分文件夹存储的，这样无论是Notes扫描（如果还没迁移）还是系统访问，都会更高效。

内容的提问来源于stack exchange，提问作者Kevin Gill