使用Retrofit 2上传图片失败：用户注册成功但图片未上传

看起来你遇到的核心问题是Retrofit构造的Multipart请求里，图片字段的表单名称和服务器端预期的不匹配——这也是为什么Chrome扩展和HTML表单能成功，但Retrofit不行的关键原因。咱们一步步拆解问题：

问题1：图片表单字段名不匹配 #

看你创建MultipartBody.Part的代码：

body = MultipartBody.Part.createFormData("name", file.getName(), requestFile);

这里第一个参数是表单字段的名称，你写的是"name"，但服务器端PHP代码里是通过$_FILES['logo']['name']来获取图片的，也就是说服务器预期的字段名是"logo"，而不是"name"。这直接导致服务器无法识别你上传的图片文件。

问题2：RequestBody的MediaType设置不准确 #

你当前设置的MediaType是：

requestFile = RequestBody.create(MediaType.parse("multipart/form-data"), file);

multipart/form-data是整个请求的Content-Type，不是单个图片文件的MIME类型。正确的做法是设置为图片对应的类型，比如image/jpeg、image/png，或者用更通用的image/*兜底。

修正后的客户端代码 #

1. 正确构造图片Part #

把表单字段名改成"logo"，并设置正确的MediaType：

// 获取图片的MIME类型
String mimeType = getContentResolver().getType(uri);
if (mimeType == null) {
    // 兜底设置为通用图片类型
    mimeType = "image/*";
}

RequestBody requestFile = RequestBody.create(MediaType.parse(mimeType), file);
// 第一个参数改为"logo"，和服务器端$_FILES['logo']对应
body = MultipartBody.Part.createFormData("logo", file.getName(), requestFile);

2. 确认Retrofit接口定义 #

你的Retrofit接口里的@Part MultipartBody.Part logo是正确的，不需要修改，只要确保传入的Part是对应logo字段的即可。

额外检查点（服务器端潜在隐患） #

虽然你说表单能成功，但还是提几个服务器端的潜在问题（不影响当前图片上传，但可能有安全或稳定性风险）：

• 代码混用了SJB_DB::query和已废弃的mysql_query，建议统一使用SJB_DB的数据库操作方法
• 用户输入直接拼接到SQL语句中，存在SQL注入风险，建议使用参数化查询
• 移动文件的逻辑里没有判断move_uploaded_file是否成功，建议增加错误日志排查

测试验证 #

修改完客户端代码后再测试：

• 小图片应该能正常被服务器识别并上传
• 大图片的响应时间会恢复正常（之前响应慢是因为图片已发出，但服务器无法识别，导致无效处理）

内容的提问来源于stack exchange，提问作者Pavel Poley