基于Socket实现Android MediaRecorder视频流传输至Node.js服务器

阿华AIGC实验室

2026-5-14

我来给你梳理几个关键的排查和解决方向，都是基于Android原生API和标准Socket通信的思路，应该能帮你定位问题：

核心排查与解决思路

1. 先确认Socket基础连接与IO是否正常

先抛开视频流，用简单的字符串/字节数组测试Android和Node.js的Socket通信是否能正常收发。比如Android端发一段固定字节，Node.js端打印接收的内容，确保连接建立、数据能跨端传输是没问题的。这一步能排除是Socket本身的连接问题，还是视频流传输的特殊问题。
检查Android端的网络权限：确保已经申请了INTERNET权限，并且如果是Android 10+，注意后台网络访问的限制（如果你的App在后台运行的话）。
检查Socket的关闭时机：如果Android端在发送流之前就意外关闭了Socket，服务器自然收不到数据。确保OutputStream是持续打开的，直到你主动停止传输。

2. 排查ParcelFileDescriptor在视频流传输中的使用问题

你提到用ParcelFileDescriptor来发送视频流，这里容易踩几个坑：

确认ParcelFileDescriptor对应的是可读的视频流源：如果是从MediaRecorder的输出获取的PFD，要确保MediaRecorder已经正确配置，并且处于录制状态，流是持续产生的。比如你是不是在MediaRecorder.start()之后才获取的PFD？如果过早获取，流是空的。

避免直接传输PFD的文件描述符本身：ParcelFileDescriptor是跨进程传递的工具，但在Socket传输中，你不能直接把PFD对象发过去，而是要读取它对应的FileInputStream的字节数据，然后通过Socket的OutputStream发送。示例代码：

ParcelFileDescriptor pfd = ...; // 从MediaRecorder或SurfaceView的录制源获取
FileInputStream fis = new FileInputStream(pfd.getFileDescriptor());
byte[] buffer = new byte[4096];
int read;
while ((read = fis.read(buffer)) != -1) {
    socket.getOutputStream().write(buffer, 0, read);
    socket.getOutputStream().flush(); // 按需flush，避免数据积压在缓冲区
}

注意MediaRecorder的输出格式：如果用的是MP4这种封装格式，它的头部信息是在录制结束后才写入的，如果你在录制过程中实时传输，Node.js端拿到的是不完整的文件流，可能无法识别。可以考虑用裸H.264流，这样实时传输的流是可解析的。

3. 视频流传输的格式与编码问题

避免传输封装格式的流（如MP4）：MP4等容器格式需要文件头和索引，实时传输时服务器拿到的是不完整的片段，无法解析。建议用裸H.264视频流（加上NALU分隔符），这样Node.js端可以逐帧解析。
如果你用MediaRecorder，要配置正确的参数：
```
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);
mediaRecorder.setVideoEncoder(MediaRecorder.VideoEncoder.H264);
```
但要注意，MPEG_4的输出在录制过程中，前面的流可能没有完整的文件头，所以服务器端需要处理这种“边录边传”的流；更简单的是用MediaCodec直接获取H.264的NALU单元，然后逐个发送。

4. Node.js端的接收逻辑优化

Node.js的Socket接收是异步的，要确保你正确监听了data事件，并且处理了数据的拼接：

const net = require('net');
const server = net.createServer((socket) => {
    console.log('Client connected');
    socket.on('data', (data) => {
        // 处理接收到的字节数据，比如写入临时文件测试
        console.log(`Received ${data.length} bytes`);
        require('fs').appendFileSync('received_video.h264', data);
    });
    socket.on('end', () => {
        console.log('Client disconnected');
    });
});
server.listen(3000, '0.0.0.0', () => {
    console.log('Server listening on port 3000');
});

注意Node.js的缓冲区：如果数据量大，data事件会触发多次，每次传递的是部分数据，你需要自己拼接完整的流（如果是解析H.264的话，要根据NALU的起始码来分割帧）。
用ffmpeg测试接收的流：把Node.js接收的字节写入文件后，用ffplay received_video.h264来测试是否是有效的视频流，这样可以判断是Android端发送的流有问题，还是Node.js端处理的问题。