如何通过MySQL数据库关联访问Alfresco存储的用户文档？

核心思路是不侵入Alfresco原生库结构，通过唯一用户标识打通自建用户表和Alfresco的文档元数据，按需选择直接关联查询或者元数据同步的方式实现，两种方案都能跑通。

第一步：改造自建用户信息表 #

在你计划创建的用户信息表里，新增一个用于关联Alfresco体系的字段，优先用Alfresco的登录账号名作为关联键，别用Alfresco侧的用户节点id当关联键，账号删除重建时节点id会变动，登录账号名是全局唯一的稳定标识。建表示例：

CREATE TABLE `sys_user_info` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '自有体系用户主键',
  `user_name` varchar(64) NOT NULL COMMENT '自有体系显示用户名',
  `alfresco_account` varchar(64) NOT NULL COMMENT '对应Alfresco系统的登录账号名',
  `extra_info` varchar(255) DEFAULT NULL COMMENT '其他用户属性按需自行添加',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_alfresco_account` (`alfresco_account`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

第二步：选择关联查询实现方式 #

方案1：轻量无同步（跨库关联Alfresco原生表查询） #

适合文档量不大、Alfresco版本长期不升级的场景，前提是你的业务库MySQL账号拥有Alfresco库的只读查询权限，账号只分配select权限即可，绝对不要给增删改权限，避免误操作损坏Alfresco元数据。
Alfresco所有文档节点的元数据都存在自带的alf_node、alf_node_properties表中，文档创建人字段直接对应用户的登录账号名，关联查询示例：

SELECT
  u.id AS user_id,
  u.user_name,
  n.uuid AS alfresco_doc_unique_id,
  p.string_value AS doc_name
FROM
  你的业务库名.sys_user_info u
LEFT JOIN
  alfresco库名.alf_node n
  ON n.audit_creator = u.alfresco_account
  AND n.type_qname = '{http://www.alfresco.org/model/content/1.0}content' -- 过滤掉文件夹节点，只返回文档
  AND n.is_deleted = 0 -- 过滤回收站里的已删除文档
LEFT JOIN
  alfresco库名.alf_node_properties p
  ON n.id = p.node_id
  AND p.qname = '{http://www.alfresco.org/model/content/1.0}name' -- 拉取文档名称属性
WHERE
  u.id = '你要查询的目标用户ID';

不同Alfresco版本的属性qname可能有细微差异，如果查询返回空，可以先查Alfresco库的alf_qname表核对对应属性的键值。

方案2：稳定无侵入（自建文档映射表） #

适合文档量大、Alfresco可能迭代升级的场景，完全不依赖Alfresco原生表结构，稳定性更高。
额外建一张文档映射表，在用户上传、删除Alfresco文档时，通过Alfresco的接口回调同步核心元数据到这张表即可，建表示例：

CREATE TABLE `alfresco_doc_mapping` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `doc_uuid` varchar(128) NOT NULL COMMENT 'Alfresco返回的文档唯一标识',
  `alfresco_account` varchar(64) NOT NULL COMMENT '文档所属用户的Alfresco账号',
  `doc_name` varchar(255) NOT NULL COMMENT '文档名称',
  `upload_time` datetime NOT NULL COMMENT '文档上传时间',
  PRIMARY KEY (`id`),
  KEY `idx_account` (`alfresco_account`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

查询时直接关联自有用户表和映射表即可，不需要跨库访问Alfresco，性能更高：

SELECT
  u.user_name,
  m.doc_uuid,
  m.doc_name,
  m.upload_time
FROM sys_user_info u
LEFT JOIN alfresco_doc_mapping m
ON u.alfresco_account = m.alfresco_account
WHERE u.id = '目标用户ID';

落地注意事项 #

• 不要直接修改Alfresco原生库的表结构，不要往Alfresco原生表写入业务数据，所有业务关联逻辑都在自有业务库实现，避免Alfresco升级、重启时出现数据不一致。
• 查询到文档唯一ID后，访问文档时要走Alfresco官方的鉴权接口生成临时访问凭证，不要直接拼接访问地址绕过权限校验。
• 单用户文档量超过1000份时，优先选映射表方案，跨库关联查询的性能会随数据量上升明显下降。

内容的提问来源于stack exchange，提问作者Dr Brown