如何使用Java通过REST API获取SharePoint列表中的文件内容（新手求助）

阿华AIGC实验室

2026-5-15

用Java通过SharePoint REST API获取列表文件内容的步骤

嘿，作为SharePoint新手，我完全理解这种想快速上手通过API拿文件内容的需求！下面我会一步步给你讲清楚具体怎么做，附带Java代码示例，跟着来就行～

一、先搞清楚几个关键前提

你得提前准备好这些信息：

你的SharePoint站点完整URL（比如https://yourtenant.sharepoint.com/sites/yourSite）
目标列表的名称（比如“文档库测试”）
拥有该列表读取权限的账号（用户名+密码，或者应用权限凭证，新手先从账号密码入手更简单）

二、核心步骤：认证 + 调用API

SharePoint REST API需要先通过认证才能访问，不同环境（Online/本地服务器）认证方式略有不同，这里重点讲SharePoint Online的实现，本地的话可以参考NTLM认证的方式调整。

1. 依赖准备

首先你的Java项目里要引入HTTP客户端的依赖，比如Apache HttpClient，如果你用Maven的话，在pom.xml里加：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version>
</dependency>
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpmime</artifactId>
    <version>4.5.14</version>
</dependency>

2. 实现认证与API调用

这里分两步：先获取列表中文件的服务器相对路径，再通过路径获取文件内容。

第一步：获取文件的服务器相对URL

我们先调用REST API获取列表里的文件信息，拿到FileRef（就是服务器相对路径）：

import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import java.io.IOException;

public class SharePointRestExample {
    private static final String SITE_URL = "https://yourtenant.sharepoint.com/sites/yourSite";
    private static final String LIST_NAME = "文档库测试";
    private static final String USERNAME = "your-account@yourtenant.onmicrosoft.com";
    private static final String PASSWORD = "your-password";

    public static void main(String[] args) throws IOException {
        // 1. 设置认证凭证
        CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
        credentialsProvider.setCredentials(AuthScope.ANY,
                new UsernamePasswordCredentials(USERNAME, PASSWORD));

        // 2. 构建HttpClient
        try (CloseableHttpClient httpClient = HttpClients.custom()
                .setDefaultCredentialsProvider(credentialsProvider)
                .build()) {

            // 3. 构造获取文件列表的API请求
            String listItemsUrl = SITE_URL + "/_api/web/lists/getbytitle('" + LIST_NAME + "')/items?$select=FileRef,FileLeafRef";
            HttpGet getItemsRequest = new HttpGet(listItemsUrl);
            getItemsRequest.addHeader("Accept", "application/json;odata=verbose");

            // 4. 发送请求并解析响应
            HttpResponse itemsResponse = httpClient.execute(getItemsRequest);
            String itemsJson = EntityUtils.toString(itemsResponse.getEntity());
            System.out.println("文件列表信息：" + itemsJson);

            // 这里你可以解析JSON，提取出目标文件的FileRef，比如假设第一个文件是你要的
            // 实际项目里建议用JSON库（比如Jackson）来解析，这里简化处理
            String fileServerRelativeUrl = "/sites/yourSite/文档库测试/test.txt"; // 替换成实际的FileRef值

            // 第二步：获取文件内容
            getFileContent(httpClient, fileServerRelativeUrl);
        }
    }

    private static void getFileContent(CloseableHttpClient httpClient, String fileServerRelativeUrl) throws IOException {
        // 构造获取文件内容的API请求
        String fileContentUrl = SITE_URL + "/_api/web/getfilebyserverrelativeurl('" + fileServerRelativeUrl + "')/$value";
        HttpGet getContentRequest = new HttpGet(fileContentUrl);

        // 发送请求并读取内容
        HttpResponse contentResponse = httpClient.execute(getContentRequest);
        byte[] fileBytes = EntityUtils.toByteArray(contentResponse.getEntity());

        // 这里可以把字节数组转成字符串（如果是文本文件）或者写入本地文件
        String fileContent = new String(fileBytes, "UTF-8");
        System.out.println("文件内容：" + fileContent);

        // 如果是二进制文件（比如图片、PDF），可以写入本地：
        // Files.write(Paths.get("local-file.pdf"), fileBytes);
    }
}

3. 关键说明

认证部分：这里用的是账号密码认证，适合测试环境；生产环境建议用Azure AD应用权限认证（更安全），不过新手先从这个入手。
API端点说明：
- 获取列表文件：/_api/web/lists/getbytitle('列表名')/items?$select=FileRef,FileLeafRef，$select用来指定只返回需要的字段，减少响应大小。
- 获取文件内容：/_api/web/getfilebyserverrelativeurl('文件相对路径')/$value，加上$value直接返回文件的二进制内容。
JSON解析：示例里简化了JSON解析，实际项目中推荐用Jackson或者Gson来解析itemsJson，提取d.results里的FileRef字段。