Android端Post WAV文件至服务器失败，PHP中$_FILE返回Array()

我之前也遇到过类似的问题，用URLConnection做文件上传时，PHP端$_FILE返回空数组大多是请求格式不规范或者请求头设置错误导致的。结合你的场景（上传WAV到本地Kaldi服务器），我整理了几个关键修复点和代码示例：

核心问题分析 #

$_FILE为空通常和这几个因素有关：

• 没有正确设置multipart/form-data请求头，缺少必要的boundary分隔符
• 请求体的格式不符合multipart规范，字段名、文件标识和PHP端不匹配
• PHP配置的上传限制（比如upload_max_filesize太小）阻止了文件接收
• Android端代码没有完整构建文件上传的请求体

修正后的Android端Kotlin代码示例 #

这里给你一个完整的UploadFileTask实现，你可以对照自己的代码调整：

private class UploadFileTask(private val context: Context) : AsyncTask<String, Void, String>() {

    override fun doInBackground(vararg params: String): String {
        val wavFilePath = params[0]
        val uploadApiUrl = "http://你的本地服务器地址/upload.php" // 替换成实际接口地址
        val wavFile = File(wavFilePath)
        
        if (!wavFile.exists()) return "错误：WAV文件不存在"

        // 生成唯一的boundary分隔符，避免和文件内容冲突
        val boundary = "----KaldiUploadBoundary${System.currentTimeMillis()}"
        val conn = URL(uploadApiUrl).openConnection() as HttpURLConnection

        try {
            conn.doInput = true
            conn.doOutput = true
            conn.useCaches = false
            // 关键：必须带boundary的Content-Type，这是PHP识别multipart上传的核心
            conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=$boundary")

            val outputStream = DataOutputStream(conn.outputStream)

            // 写入文件字段的头部信息，name要和PHP端$_FILE的键对应
            outputStream.writeBytes("--$boundary\r\n")
            outputStream.writeBytes("Content-Disposition: form-data; name=\"uploaded_wav\"; filename=\"${wavFile.name}\"\r\n")
            outputStream.writeBytes("Content-Type: audio/wav\r\n\r\n")

            // 写入WAV文件二进制内容
            val fileInputStream = FileInputStream(wavFile)
            val buffer = ByteArray(4096)
            var bytesRead: Int
            while (fileInputStream.read(buffer).also { bytesRead = it } != -1) {
                outputStream.write(buffer, 0, bytesRead)
            }
            fileInputStream.close()

            // 结束请求体，必须严格按照格式写
            outputStream.writeBytes("\r\n--$boundary--\r\n")
            outputStream.flush()
            outputStream.close()

            // 处理服务器响应
            return if (conn.responseCode == HttpURLConnection.HTTP_OK) {
                val responseText = conn.inputStream.bufferedReader().readText()
                "上传成功：$responseText"
            } else {
                "上传失败，响应码：${conn.responseCode}"
            }
        } catch (e: Exception) {
            e.printStackTrace()
            return "上传出错：${e.message}"
        } finally {
            conn.disconnect()
        }
    }

    override fun onPostExecute(result: String) {
        super.onPostExecute(result)
        Toast.makeText(context, result, Toast.LENGTH_LONG).show()
    }
}

PHP端接收代码示例 #

确保你的upload.php字段名和Android端的name="uploaded_wav"一致，同时检查服务器权限：

<?php
// 先打印$_FILE排查问题
print_r($_FILES);

if (isset($_FILES['uploaded_wav']) && $_FILES['uploaded_wav']['error'] === UPLOAD_ERR_OK) {
    $targetDir = './kaldi_uploads/';
    // 确保目标目录存在且有写入权限
    if (!file_exists($targetDir)) {
        mkdir($targetDir, 0777, true);
    }
    $targetPath = $targetDir . basename($_FILES['uploaded_wav']['name']);
    
    if (move_uploaded_file($_FILES['uploaded_wav']['tmp_name'], $targetPath)) {
        echo "文件已保存至：$targetPath";
    } else {
        echo "移动文件失败，请检查目录权限";
    }
} else {
    echo "上传错误，错误码：" . ($_FILES['uploaded_wav']['error'] ?? '未知');
}
?>

额外排查步骤 #

1. 检查PHP配置：修改php.ini中的upload_max_filesize和post_max_size为合适的值（比如10M以上），重启服务器
2. 抓包验证：用Charles或Wireshark抓取Android端的请求，确认请求体格式是否符合multipart规范
3. 权限检查：确保本地服务器的上传目录有写入权限，Android设备能正常访问服务器地址

内容的提问来源于stack exchange，提问作者Naoki Nakamura