如何将SharePoint文档库地址重定向至其他URL？

阿华AIGC实验室

2026-5-7

Hey Vincent, 针对你要把https://testdomain.sharepoint.com/sites/test-a/Shared%20Documents/Forms/AllItems.aspx重定向到test-b站点对应文档库页面的需求，我给你几个经过验证的可行方案，你可以根据自己的环境选择：

方案1：SPFx应用程序自定义器（适用于现代体验文档库）

这是微软官方推荐的现代SharePoint页面重定向方案，不会因为页面更新失效：

首先创建一个SPFx应用程序自定义器项目，在核心逻辑里添加重定向判断：

import { override } from '@microsoft/decorators';
import { Log } from '@microsoft/sp-core-library';
import { BaseApplicationCustomizer } from '@microsoft/sp-application-base';

const LOG_SOURCE: string = 'DocLibRedirectCustomizer';

export interface IRedirectCustomizerProperties {
  targetUrl: string;
  sourcePath: string;
}

export default class RedirectCustomizer extends BaseApplicationCustomizer<IRedirectCustomizerProperties> {

  @override
  public onInit(): Promise<void> {
    Log.info(LOG_SOURCE, `Redirect customizer initialized`);

    const { targetUrl, sourcePath } = this.properties;
    if (!targetUrl || !sourcePath) return Promise.resolve();

    const currentUrl = window.location.href;
    // 匹配源路径且避免循环重定向
    if (currentUrl.includes(sourcePath) && currentUrl !== targetUrl) {
      window.location.replace(targetUrl);
    }

    return Promise.resolve();
  }
}

打包部署这个扩展到你的SharePoint租户，绑定到test-a站点，配置属性时：
- sourcePath设为sites/test-a/Shared%20Documents/Forms/AllItems.aspx
- targetUrl设为你的目标地址
部署完成后，访问原文档库页面就会自动跳转

方案2：脚本编辑器Web部件（适用于经典体验文档库）

如果你的文档库是经典模式，操作起来更简单：

打开test-a站点的文档库AllItems.aspx页面，点击顶部的「编辑页面」

添加「脚本编辑器」Web部件，插入以下代码：

<script type="text/javascript">
  const targetUrl = "https://testdomain.sharepoint.com/sites/test-b/Shared%20Documents/Forms/AllItems.aspx";
  const currentUrl = window.location.href;

  // 防止循环重定向
  if (currentUrl !== targetUrl && currentUrl.includes("Shared%20Documents/Forms/AllItems.aspx")) {
    window.location.replace(targetUrl);
  }
</script>

保存页面即可生效，后续访问原页面会直接跳转

方案3：租户级URL重定向规则（适用于批量路径重定向）

如果你需要让test-a文档库下的所有路径（比如视图、文件链接）都重定向到test-b的对应位置，可以用租户管理员权限设置全局重定向：

登录SharePoint管理中心，进入「设置」→「URL重定向」
新建一条规则：
- 源URL模式：https://testdomain.sharepoint.com/sites/test-a/Shared%20Documents/(.*)
- 目标URL：https://testdomain.sharepoint.com/sites/test-b/Shared%20Documents/$1
- 匹配类型选择「正则表达式」
保存规则后，整个文档库的所有子路径都会自动映射到目标站点的对应位置