Marshal.Copy无法将字节数组复制到IntPtr指定地址的结构体

阿华AIGC实验室

2026-5-25

我来帮你搞定这个Marshal.Copy的问题，这类非托管内存和结构体互操作的坑我踩过不少，咱们一步步排查解决：

可能的问题点及对应解决方案

1. 结构体缺少内存布局属性

这是最常见的坑！CLR默认会自动调整结构体字段的内存位置，导致和文件里的字节结构不匹配，Marshal.Copy自然无法正确工作。给你的HeaderStruct加上StructLayout属性，明确指定内存布局：

<StructLayout(LayoutKind.Sequential, Pack:=1)> ' Pack:=1表示按1字节对齐，根据文件实际对齐方式调整
Public Structure HeaderStruct
    Public MajorVersion As Short
    Public MinorVersion As Short
    Public Count As Integer
End Structure

注意：Pack值要和文件中结构体的实际对齐规则一致，如果文件用的是4字节默认对齐，就把Pack改成4或者直接去掉这个参数用默认值。

2. 确保IntPtr指向的内存空间足够

你不能直接用一个未初始化的IntPtr来接收字节，必须先分配足够容纳整个结构体的非托管内存。比如：

' 先获取结构体的内存大小
Dim structSize As Integer = Marshal.SizeOf(GetType(HeaderStruct))
' 分配对应大小的非托管内存
Dim targetPtr As IntPtr = Marshal.AllocHGlobal(structSize)

如果你的grHeaderStr是已经存在的指针，一定要确认它指向的内存大小至少等于structSize，否则复制时会触发内存越界错误。

3. 检查Marshal.Copy的调用参数顺序

Marshal.Copy有多个重载，把字节数组复制到非托管内存的正确调用方式是：

' 假设fileBytes是从文件中读取的对应结构体的字节数组
Marshal.Copy(fileBytes, 0, targetPtr, structSize)

要注意这几个细节：

fileBytes的长度必须≥structSize，否则会抛出ArgumentException
第二个参数是字节数组的起始索引，一般填0就行
第四个参数是要复制的字节数，必须和结构体大小完全一致

4. 正确把非托管内存转换为结构体实例

复制完成后，你需要把指针指向的内存转换成结构体对象，而不是直接操作指针：

Dim headerInstance As HeaderStruct = Marshal.PtrToStructure(Of HeaderStruct)(targetPtr)
' 重中之重：用完非托管内存一定要释放！
Marshal.FreeHGlobal(targetPtr)

如果跳过这一步直接操作指针，很容易出现内存访问异常或者值错乱的问题。

5. 跨平台字节序问题（如果文件来自其他系统）

如果你的文件是在Linux/Mac等平台生成的，可能存在大端/小端字节序不匹配的问题。这时候Marshal.Copy能成功复制，但结构体里的数值会是错的。解决方法是手动转换字节序：

' 把网络字节序（大端）转换为主机字节序（Windows是小端）
headerInstance.MajorVersion = System.Net.IPAddress.NetworkToHostOrder(headerInstance.MajorVersion)
headerInstance.MinorVersion = System.Net.IPAddress.NetworkToHostOrder(headerInstance.MinorVersion)
headerInstance.Count = System.Net.IPAddress.NetworkToHostOrder(headerInstance.Count)

常见错误快速排查