Spring Boot+UCanAccess连接含SharePoint列表的.accdb查询报错

以下是针对问题的具体排查和解决步骤：

1. 确认列表的实际存储名称 #

Access中显示的SharePoint链接列表名称，和UCanAccess识别的底层存储名称可能不一致（比如带后缀、下划线，或因特殊字符被转义）。先执行代码枚举所有可用表/列表，确认目标对象的真实名称：

DatabaseMetaData meta = conn.getMetaData();
ResultSet tables = meta.getTables(null, null, "%", new String[]{"TABLE"});
while (tables.next()) {
    String tableName = tables.getString("TABLE_NAME");
    log.info("系统识别的表/列表：" + tableName);
}

如果列表名称包含空格或特殊字符，SQL语句中必须用方括号包裹，例如：

SELECT * FROM [我的SharePoint列表]

2. 修复UCanAccess对链接表的兼容性问题 #

UCanAccess对Access的外部链接表（尤其是SharePoint链接）支持存在局限性，可尝试：

• 升级UCanAccess版本：将依赖更新至最新稳定版（当前为5.0.4），修复旧版本的链接表兼容bug：

<dependency>
    <groupId>net.sf.ucanaccess</groupId>
    <artifactId>ucanaccess</artifactId>
    <version>5.0.4</version>
</dependency>

• 转为本地表测试：将SharePoint列表导出为Access本地表，再执行查询，排除链接机制本身的问题。

3. 调整连接字符串参数 #

尝试添加链接表处理相关的连接参数，强制UCanAccess加载链接列表元数据：

conn = DriverManager.getConnection(
    "jdbc:ucanaccess://SHAREPOINT_COMUN.accdb;memory=false;jackcessOpener=net.sf.ucanaccess.jdbc.JackcessOpenerInterface",
    user, password
);

也可尝试启用内存模式（memory=true），让UCanAccess将链接表数据加载到内存后再查询。

4. 验证权限细节 #

• 确认连接时传入的user和password是拥有该SharePoint站点访问权限的有效凭据，UCanAccess会通过Access传递这些权限到SharePoint。
• 检查.accdb文件本身的系统权限：确保程序对该文件拥有读写权限（UCanAccess需要写入临时元数据文件来处理链接表）。

内容的提问来源于stack exchange，提问作者K1000-O