Docker运行Cube.js入门文档默认命令时出现Cube Store启动panic错误

完整报错日志（中文翻译） #

警告：未找到cube.js配置文件，将读取环境变量运行
🔥 Cube Store（版本0.28.31）已分配端口3030
警告：开发模式下需要配置apiSecret参数，Cube.js已自动生成：e3b8c5a35fe378f4d481ada777e5f3c4
🔓 开发模式下已关闭身份校验，如需开启请设置NODE_ENV=production
🦅 开发环境访问地址：http://localhost:4000
🚀 Cube.js服务（版本0.28.31）已在4000端口启动监听
2021-09-03 15:06:01,512 INFO  [cubestore::http::status] <pid:17> 状态探针服务已在0.0.0.0:3031启动
2021-09-03 15:06:01,515 INFO  [cubestore::metastore] <pid:17> 加载已有元数据，路径：/cube/conf/.cubestore/data/metastore
线程'main'触发panic，位置：/project/cubestore/src/metastore/mod.rs:1542:40
错误信息：调用`Result::unwrap()`时遇到Err值：Error { message: "IO错误：执行目录fsync操作时参数无效" }
提示：设置`RUST_BACKTRACE=1`环境变量可输出完整回溯信息
Cube Store启动错误：undefined

核心错误原因 #

该错误由Cube Store元数据存储目录所在的文件系统不支持fsync系统调用触发，常见于Docker绑定挂载宿主非Linux原生文件系统的场景，比如Windows/macOS本地目录挂载、WSL1挂载的Windows分区、exFAT/FAT32格式分区、网络共享盘等。Cube Store的0.28.x版本Rust实现中，元数据写入后会强制调用fsync刷盘，文件系统不支持该操作就会触发panic导致启动失败。

解决方案 #

• 方案一：使用Docker Volume存储数据
  不要直接绑定挂载宿主本地文件夹作为/cube/conf目录，改用Docker托管的Volume存储配置和Cube Store元数据，示例启动命令：

  docker run -p 4000:4000 -v cube-conf:/cube/conf cubejs/cube:latest
  

• 方案二：临时禁用fsync校验（仅适合本地开发）
  启动容器时新增CUBESTORE_METASTORE_FSYNC=false环境变量跳过fsync检查，示例启动命令：

  docker run -p 4000:4000 -e CUBESTORE_METASTORE_FSYNC=false -v ${PWD}:/cube/conf cubejs/cube:latest
  

  注意：该配置会降低元数据持久性，生产环境请勿使用
• 方案三：升级Cube.js版本
  该问题是0.28.x版本的已知兼容性缺陷，升级到0.29.0及以上版本的官方Cube.js镜像即可修复。

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