IBM i/OS400上Node.js带重音文件名无法访问问题求助

核心问题原因 #

IBM i的IFS文件系统存储文件名采用CCSID 1208（UTF-8），但QSH启动的Node.js进程默认会使用作业CCSID（如1147）处理字符串编码，导致文件名在“读取目录→解析文件名→打开文件”的流程中出现编码不匹配，最终触发ENOENT异常。

具体解决思路 #

1. 直接用Buffer传递文件名（推荐） #

Node.js的fs API支持传入Buffer作为路径参数，绕开字符串编码转换的问题：

• 读取目录时，获取文件名的原始字节缓冲区：

  const filenames = await fsPromises.readdir(mydir, { encoding: 'buffer' });
  

• 如需显示文件名，将缓冲区从作业CCSID（1147）转成UTF-8字符串（需先安装iconv-lite包）：

  const iconv = require('iconv-lite');
  for (const filenameBuffer of filenames) {
    const displayName = iconv.decode(filenameBuffer, 'cp1147');
    console.log('文件名：', displayName);
    // 直接用Buffer打开文件
    const fileContent = await fsPromises.readFile(filenameBuffer);
    // 处理文件内容...
  }
  

2. 强制Node.js使用UTF-8环境 #

修改启动脚本，在执行Node.js前设置UTF-8相关环境变量：

• 编辑启动Node.js的SH脚本，开头添加：

  export LANG=EN_US.UTF-8
  export QIBM_MULTI_THREADED=Y
  node app.js &
  

• 或者修改CL启动命令，直接在QSH中指定环境变量：

  CMD(QSH CMD("export LANG=EN_US.UTF-8; export QIBM_MULTI_THREADED=Y; &CMD")) JOB(&JOB) JOBQ(QUSRNOMAX) CCSID(1208) SPLFACN(*DETACH)
  

3. 检查并调整作业CCSID设置 #

尝试将作业CCSID显式设置为1208（UTF-8），避免编码转换冲突：

• 在CL命令中指定CCSID(1208)，同时确保QSH环境继承该设置
• 若仍无效，可在QSH中执行echo $LANG和echo $CCSID确认当前编码环境，确保输出为UTF-8相关值

4. 升级Node.js版本 #

当前使用的Node.js 14.21.3版本较旧，可尝试升级到Node.js 18的最新LTS版本，后续版本对IBM i平台的编码兼容性有优化，可能解决此类问题。

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