Node.js上传本地文件至Laravel服务器返回Null问题排查

我看你遇到的问题是Node.js端用axios上传本地文件到Laravel时，服务器拿不到文件，dump($request->all())返回空数组，但普通POST请求能正常到达服务器对吧？我之前也碰到过类似的情况，核心问题出在请求头的设置上，咱们一步步来解决：

1. 不要手动设置multipart/form-data请求头 #

你现在手动指定了content-type: multipart/form-data，但FormData对象会自动生成包含**boundary（分隔符）**的请求头——这是服务器解析多部分表单数据必需的标识。手动设置会覆盖这个带boundary的头，导致Laravel无法正确解析文件内容。

修改你的app.js代码，改用FormData自带的请求头：

const fs = require('fs')
const path = require('path')
const axios = require('axios')
const FormData = require('form-data')

// 先确认文件存在，避免传递空流
const filePath = path.join(__dirname, 'screenshot.jpg');
if (!fs.existsSync(filePath)) {
  console.error('错误：目标文件不存在', filePath);
  process.exit(1);
}

let formData = new FormData()
formData.append('screenshot-file', fs.createReadStream(filePath))

axios.post(
  `https://www.myapp.com/api/upload-screenshot`,
  formData,
  { headers: formData.getHeaders() } // 使用FormData自动生成的请求头
)
.then(response => {
  console.log('上传成功：', response.data);
})
.catch(error => {
  console.error('上传失败：', error.response?.data || error.message);
})

或者更简单，直接省略headers配置，axios会自动识别FormData并设置正确的请求头：

axios.post(
  `https://www.myapp.com/api/upload-screenshot`,
  formData
)

2. 完善Laravel端的错误处理与验证 #

现在你的控制器直接调用$file->move()，如果文件不存在会直接抛出致命错误。先添加验证和目录检查，方便排查问题：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Validator;

class ScreenshotController extends Controller {
  public function upload(Request $request) {
    // 先验证文件是否存在且符合要求
    $validator = Validator::make($request->all(), [
      'screenshot-file' => 'required|file|image',
    ]);

    if ($validator->fails()) {
      return response()->json(['error' => $validator->errors()], 400);
    }

    $file = $request->file('screenshot-file');
    $filename = 'screenshot.jpg';
    $uploadPath = storage_path('/uploads/screenshots/');

    // 确保上传目录存在，避免move失败
    if (!file_exists($uploadPath)) {
      mkdir($uploadPath, 0755, true);
    }

    $file->move($uploadPath, $filename);
    return response()->json(['filename' => $filename], 200);
  }
}

3. 额外排查点 #

• 确认Node.js端的文件路径正确：可以用console.log(filePath)打印路径，检查是否指向真实存在的screenshot.jpg文件。
• 检查Laravel的API路由定义：确保routes/api.php中有对应POST路由，比如Route::post('/upload-screenshot', [ScreenshotController::class, 'upload']);。
• 确认Laravel存储目录权限：storage/uploads/screenshots需要有读写权限，本地测试可执行chmod -R 755 storage/。

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