Win10 WSL2新装Crystal与Lucky框架后启动服务报File::Error异常
问题场景
刚完成Crystal语言与Lucky框架安装,运行环境为Windows 10下的WSL2,尝试启动Lucky服务时触发未处理异常,异常堆栈如下:
Unhandled exception: Unable to get file info: '/mnt/c/Python27/overmind': Input/output error (File::Error) from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/crystal/system/unix/file.cr:44:9 in 'info?' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/file.cr:132:5 in 'info?' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/process/executable_path.cr:32:12 in 'is_executable_file?' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/process/executable_path.cr:49:10 in 'find_executable' from /home/sashacode/apps/lucky_cli/src/lucky_cli/process_runner.cr:26:9 in 'installed?' from /home/sashacode/apps/lucky_cli/src/lucky_cli/process_runner.cr:22:24 in 'installed_process_runners' from /home/sashacode/apps/lucky_cli/src/lucky_cli/process_runner.cr:13:20 in 'start' from /home/sashacode/apps/lucky_cli/src/lucky_cli/process_runner.cr:12:5 in 'start' from /home/sashacode/apps/lucky_cli/src/dev.cr:5:5 in 'call' from /home/sashacode/apps/lucky_cli/src/dev.cr:4:3 in 'call' from /home/sashacode/apps/lucky_cli/src/lucky.cr:30:3 in '__crystal_main' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/crystal/main.cr:110:5 in 'main_user_code' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/crystal/main.cr:96:7 in 'main' from /home/sashacode/.asdf/installs/crystal/0.36.1/share/crystal/src/crystal/main.cr:119:3 in 'main' from __libc_start_main from _start from ???
报错根因
- Lucky启动开发服务时,会通过Crystal内置逻辑遍历系统PATH中的所有路径,查找已安装的overmind进程执行器作为服务运行依赖
- WSL2默认会将Windows系统的PATH路径全量映射到Linux侧的PATH变量中,Windows侧路径会被自动转换为/mnt/开头的挂载路径纳入查找范围
- WSL2访问/mnt/下的Windows挂载文件系统时,对部分权限受限、格式不兼容的文件会触发Input/output error。本次查找逻辑扫描到
/mnt/c/Python27/overmind这个无访问权限/不存在的路径时,读取文件信息失败,直接触发未捕获的File::Error导致程序崩溃
解决步骤
- 排查当前环境PATH内容:执行
echo $PATH,确认输出中包含/mnt/c开头的Windows挂载路径条目 - 配置WSL关闭自动继承Windows侧PATH的行为:打开对应shell的配置文件(bash默认编辑
~/.bashrc,zsh默认编辑~/.zshrc),在文件末尾追加配置:# 禁止WSL自动将Windows系统路径追加到Linux PATH export WSLENV= - 保存配置后执行
source ~/.bashrc(zsh用户替换为source ~/.zshrc)使配置生效,再次执行echo $PATH确认/mnt开头的Windows路径条目已被全部移除 - 在WSL原生Linux环境内安装Lucky依赖的overmind进程管理器,安装完成后执行
which overmind,确认返回路径为Linux原生路径(即/home、/usr/bin这类非/mnt开头的路径) - 重新启动Lucky开发服务,确认异常消除
注意:所有Crystal、Lucky相关的项目和依赖包,尽量存储在WSL原生的/home目录下,不要放在/mnt/开头的Windows挂载目录中。WSL2对挂载盘的文件系统兼容性差,不仅容易触发IO错误,编译、运行的性能损耗也会非常明显。
内容的提问来源于stack exchange,提问作者Sandro Palmieri
相关产品推荐
相关产品推荐

