Swift中使用multipart/form-data带参上传图片路径异常问题

咱们从最常见的几个排查点入手，一步步定位并解决问题：

1. 先确认PHP代码是否正确获取了multipart/form-data中的路径参数 #

首先检查你的upload_image.php里，是不是从表单参数里正确读取了目标路径。比如如果前端传的参数名是target_path，那代码里应该用$_POST['target_path']来获取（注意multipart/form-data类型的请求，普通参数存在$_POST里，文件信息在$_FILES中）。

如果代码里写错了参数名（比如把target_path写成save_path），或者压根没正确获取参数，就会触发代码里的默认逻辑（比如默认保存到根目录./）。

你可以在代码开头加一段调试代码，验证参数是否正确接收：

var_dump($_POST); // 打印所有POST参数，确认target_path是否存在且值符合预期
exit;

发起请求后查看返回内容，就能直观判断参数有没有传对。

2. 检查路径拼接与目录存在性处理 #

假设已经正确拿到了路径参数，接下来要确认路径拼接和目录是否存在：

• 比如参数是uploads/user_123/，保存文件时要确保路径末尾有目录分隔符，避免出现uploads/user_123filename.jpg这种错误路径：

$target_path = $_POST['target_path'];
// 确保路径末尾带目录分隔符
if (substr($target_path, -1) !== DIRECTORY_SEPARATOR) {
    $target_path .= DIRECTORY_SEPARATOR;
}

• 还要确保目标目录存在，否则move_uploaded_file会失败，可能 fallback 到根目录。可以提前递归创建目录：

if (!is_dir($target_path)) {
    mkdir($target_path, 0755, true); // 0755是目录权限，true表示递归创建父目录
}

另外，一定要做路径合法性校验，防止目录遍历攻击：

// 限制所有上传路径必须在指定的根目录下
$allowed_root = '/var/www/storage/';
$real_target = realpath($allowed_root . $target_path);
if (strpos($real_target, $allowed_root) !== 0) {
    die("非法路径请求");
}

3. 注意API URL结构的坑 #

你提到API格式类似https://storage.myWebsiteName.com/upload_image.php/...，这里要注意：PHP会把upload_image.php后面的部分放到$_SERVER['PATH_INFO']变量里。如果你的代码误把$_SERVER['PATH_INFO']当成了目标路径，而不是从multipart表单参数里读取，就会导致路径完全错误。

比如如果代码里写了：

$target_path = $_SERVER['PATH_INFO'];

但你实际是想从表单参数里拿路径，那得改成从$_POST中获取。

4. 检查文件上传的错误信息 #

最后别忘了查看$_FILES里的错误码，确认上传过程有没有异常：

if ($_FILES['image']['error'] !== UPLOAD_ERR_OK) {
    switch ($_FILES['image']['error']) {
        case UPLOAD_ERR_INI_SIZE:
            $error = '上传文件超过php.ini限制的大小';
            break;
        case UPLOAD_ERR_FORM_SIZE:
            $error = '上传文件超过表单限制的大小';
            break;
        default:
            $error = '上传发生未知错误';
    }
    die($error);
}

总结一下，最可能的原因就是参数获取错误或者路径拼接/目录存在性问题，先通过调试代码确认参数是否正确接收，再一步步排查后续逻辑~

内容的提问来源于stack exchange，提问作者Awais Fayyaz