Flutter/Dart发送图片至Apache服务器PHP接口返回null错误原因排查
问题核心原因
报错是端侧代码时序、格式不匹配、逻辑错误共同导致的,没有单一问题点:
- Flutter端存在异步时序bug,极易传入空值
全局变量base64Image是在FutureBuilder的UI绘制流程里异步赋值的,不是在文件选择完成时就赋值的。用户点击上传时,很可能还没执行到base64编码逻辑,请求体里的image字段实际为null。 - 请求格式不符合服务端解析规则,容易被中间件丢弃
原代码里http.post默认使用application/x-www-form-urlencoded格式传参,超长base64字符串很容易触发PHP的post_max_size、max_input_vars配置限制,导致整个请求体被服务端丢弃,所有POST参数读出来都是null。 - PHP端存在双重编码的逻辑错误
Flutter端已经完成了图片的base64编码,服务端拿到参数后又执行了一次base64_encode($image),相当于对已编码的字符串做二次转码,传到下游AWS服务的内容完全不符合格式要求,自然会返回null。 - PHP端残留无效代码、请求头不匹配
代码里保留了针对multipart/form-data上传的$_FILES读取逻辑,但实际根本没有走文件上传流,这段无效代码不仅没有作用,还会触发PHP未定义变量的警告;同时用curl转发请求时没有设置对应Content-Type头,下游服务无法正确解析请求体,也会返回null。
对应修正方案
Flutter侧调整
- 把base64编码逻辑从UI绘制流程挪到上传触发的回调里,不依赖全局变量的异步赋值,避免空值问题
- 发送请求时明确使用JSON格式传参,避免表单编码的长度限制问题
修正后的核心上传逻辑:void upload(String fileName) async { // 先校验临时文件是否存在 if (tmpFile == null) return; // 执行编码流程,拿到明确的base64字符串 final imageBytes = await tmpFile.readAsBytes(); final base64ImageStr = base64Encode(imageBytes); await http.post( Uri.parse(uploadEndPoint), // 指定JSON格式的请求头 headers: {"Content-Type": "application/json"}, body: jsonEncode({ "image": base64ImageStr, "name": fileName, }), ).then((result) { setStatus(result.statusCode == 200 ? result.body : errMessage); }).catchError((error) { setStatus(error); }); }
PHP侧调整
- 删掉完全无效的
$_FILES相关残留代码 - 适配Flutter传的JSON格式,手动从请求流里读取参数,不要依赖默认的
$_POST(PHP不会自动解析JSON格式的请求体到$_POST超全局变量) - 去掉多余的二次base64编码逻辑,直接把客户端传过来的编码内容转发给下游
- 给curl转发请求加上匹配的
Content-Type头,保证下游服务能正确解析
修正后的PHP核心逻辑:<?php header('Access-Control-Allow-Origin: *'); header('Access-Control-Allow-Methods: GET, POST, PATCH, PUT, DELETE, OPTIONS'); header('Access-Control-Allow-Headers: Origin, Content-Type, X-Auth-Token'); // 读取JSON格式的请求体 $requestData = json_decode(file_get_contents('php://input'), true); $image = $requestData['image'] ?? ''; $name = $requestData['name'] ?? ''; $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, "xxx.xxx.xxx.xxx:5000/image/test"); curl_setopt($curl, CURLOPT_TIMEOUT, 30); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // 设置正确的请求头 curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); // 直接转发客户端传过来的参数,不做多余编码 curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([ 'image' => $image, 'name' => $name ])); $response = curl_exec($curl); curl_close($curl); echo $response; ?>
内容的提问来源于stack exchange,提问作者Naratip Paedilokkun
相关产品推荐
相关产品推荐

