向mmap分配的切片写入时触发panic问题排查

触发index out of range panic的核心原因是你映射的内存区域长度为0，根本没有可写入的空间，具体诱因有两个：

1. 文件未初始化有效大小 #

你用os.OpenFile打开的./file要么是空文件，要么是不存在但因错误被忽略导致后续映射无效：

• 如果文件原本不存在，仅用os.O_RDWR flag调用os.OpenFile会失败，但你用_忽略了错误，后续执行mmap.Map时会得到长度为0的映射区域。
• 如果文件存在但大小为0，mmap会映射一块长度为0的内存，此时访问索引0必然越界。

2. 完全忽略错误处理 #

代码中所有IO和映射操作的错误都被直接丢弃，这会让你无法及时发现文件打开失败、映射失败等问题，直接进入无效状态的后续操作，最终触发panic。

方案1：初始化文件大小 #

先确保文件有足够的大小（比如预分配1字节或更大空间），再进行映射：

package main

import (
    "fmt"
    "os"

    "github.com/edsrzf/mmap-go"
)

func main() {
    // 用O_CREATE确保文件存在，O_RDWR用于读写
    f, err := os.OpenFile("./file", os.O_RDWR|os.O_CREATE, 0644)
    if err != nil {
        fmt.Printf("open file failed: %v\n", err)
        return
    }
    defer f.Close()

    // 预分配文件大小为1字节（按需调整）
    if err := f.Truncate(1); err != nil {
        fmt.Printf("truncate file failed: %v\n", err)
        return
    }

    mmap, err := mmap.Map(f, mmap.RDWR, 0)
    if err != nil {
        fmt.Printf("mmap failed: %v\n", err)
        return
    }
    defer mmap.Unmap()

    fmt.Println("original data:", string(mmap))
    mmap[0] = 'X'
    if err := mmap.Flush(); err != nil {
        fmt.Printf("flush failed: %v\n", err)
    }
    fmt.Println("after write:", string(mmap))
}

方案2：写入时动态扩展文件（可选） #

如果需要动态扩展映射区域，你需要先扩展文件大小，再重新映射（mmap本身无法直接动态扩展，需重新操作）。

• 永远不要忽略IO和系统调用的错误，这些错误是排查问题的关键线索。
• mmap的内存区域长度完全对应文件的实际大小，操作前必须确保文件有足够的空间。

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