Android中如何向服务器发送包含多张图片的JSON文件？

嘿，我来帮你解决这个Android上传带图片的JSON的问题！你现在的JSON里存的是本地图片路径，直接发这个JSON给服务器没用——服务器根本访问不到你设备上的本地文件对吧？正确的做法是用Multipart/form-data请求，把JSON数据和图片文件打包一起上传，下面是具体的实现步骤和代码：

我们需要把两部分内容传给服务器：

• 原始的JSON数据（作为一个普通参数）
• JSON里对应的每张图片文件（作为文件参数，要给每个文件设置唯一的标识key，方便服务器对应到JSON里的条目）

首先确保你已经在项目里添加了OkHttp依赖，在app/build.gradle的dependencies里加上：

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

然后是核心上传代码：

import okhttp3.MediaType;
import okhttp3.MultipartBody;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;
import org.json.JSONArray;
import org.json.JSONObject;
import java.io.File;
import java.io.IOException;

public class ImageJsonUploader {
    // 初始化OkHttpClient，建议全局单例
    private static final OkHttpClient okHttpClient = new OkHttpClient();

    /**
     * 上传带图片的JSON数据
     * @param serverUrl 服务器接口地址
     * @param jsonData 包含图片路径的JSON数组
     * @throws IOException 网络或文件异常
     */
    public static void uploadWithImages(String serverUrl, JSONArray jsonData) throws IOException {
        MultipartBody.Builder multipartBuilder = new MultipartBody.Builder()
                .setType(MultipartBody.FORM);

        // 第一步：添加JSON数据作为请求参数
        multipartBuilder.addFormDataPart("json_data", jsonData.toString());

        // 第二步：遍历JSON，添加对应的图片文件
        for (int i = 0; i < jsonData.length(); i++) {
            JSONObject item = jsonData.getJSONObject(i);
            int itemId = item.getInt("Id");
            JSONArray familyList = item.getJSONArray("familyList");

            for (int j = 0; j < familyList.length(); j++) {
                JSONObject familyItem = familyList.getJSONObject(j);
                
                // 处理photocopy图片
                String photocopyPath = familyItem.getString("photocopy");
                File photocopyFile = new File(photocopyPath);
                if (photocopyFile.exists() && photocopyFile.isFile()) {
                    multipartBuilder.addFormDataPart(
                            // 用Id+类型+索引做唯一key，服务器可以通过这个匹配JSON里的条目
                            String.format("%d_photocopy_%d", itemId, j),
                            photocopyFile.getName(),
                            RequestBody.create(photocopyFile, MediaType.parse("image/jpeg"))
                    );
                }

                // 处理signature图片
                String signaturePath = familyItem.getString("signature");
                File signatureFile = new File(signaturePath);
                if (signatureFile.exists() && signatureFile.isFile()) {
                    multipartBuilder.addFormDataPart(
                            String.format("%d_signature_%d", itemId, j),
                            signatureFile.getName(),
                            RequestBody.create(signatureFile, MediaType.parse("image/jpeg"))
                    );
                }
            }
        }

        // 构建请求并发送
        RequestBody requestBody = multipartBuilder.build();
        Request request = new Request.Builder()
                .url(serverUrl)
                .post(requestBody)
                .build();

        try (Response response = okHttpClient.newCall(request).execute()) {
            if (!response.isSuccessful()) {
                throw new IOException("请求失败，响应码：" + response.code());
            }
            // 打印服务器返回的结果，实际项目里可以根据需求处理
            System.out.println("服务器响应：" + response.body().string());
        }
    }

    // 调用示例
    public static void main(String[] args) {
        try {
            // 你的原始JSON数据
            String rawJson = "[{\"Id\": 878, \"familyList\": [{ \"photocopy\": \"/storage/sdcard/jsonFiles/captured_signs/Signature_1582782604563.jpg\", \"signature\": \"/storage/sdcard/jsonFiles/captured_signs/Signature_1582782604563.jpg\" }] }, { \"Id\": 877, \"familyList\": [{ \"photocopy\": \"/storage/sdcard/jsonFiles/captured_signs/Signature_1582802338008.jpg\", \"signature\": \"/storage/sdcard/jsonFiles/captured_signs/Signature_1582802338008.jpg\" }] }]";
            JSONArray jsonArray = new JSONArray(rawJson);
            // 替换成你的服务器接口地址
            uploadWithImages("https://your-server-domain/upload", jsonArray);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

服务器需要做两件事：

• 先解析请求里的json_data参数，拿到原始JSON结构
• 根据JSON里的Id、familyList索引，匹配对应的文件参数（比如878_photocopy_0），把文件保存到服务器存储，之后可以把JSON里的本地路径替换成服务器的访问URL（可选）

• 权限问题：Android 10及以上，访问外部存储需要申请MANAGE_EXTERNAL_STORAGE权限，或者用MediaStore/SAF（存储访问框架）获取文件，避免权限被拒绝。
• JSON序列化：实际项目里可以用Gson或Moshi替代原生JSON库，序列化和反序列化更便捷。
• 进度监听：如果上传大图片，建议给OkHttp添加进度监听，让用户看到上传进度，提升体验。
• 异常处理：代码里要处理文件不存在、网络超时、服务器错误等异常情况，避免崩溃。

内容的提问来源于stack exchange，提问作者Dattatray Patap