使用docx gem操作Word模板时出现undefined method `close' for nil错误

这个错误的核心是代码尝试对nil对象调用close方法，说明模板文件的打开流程中，某个预期为文件/文档实例的变量未正确初始化。以下是针对性的排查和解决步骤：

• 验证模板路径有效性
  先确认TEMPLATE_PATH指向的文件真实存在，执行以下代码检查：

  puts TEMPLATE_PATH
  puts File.exist?(TEMPLATE_PATH)
  puts File.readable?(TEMPLATE_PATH)
  

  重点排查相对路径的工作目录是否与预期一致，或者直接使用绝对路径避免路径解析问题。

• 调整Docx文档初始化方式
  不要用File.read包裹路径，直接将路径传入Docx::Document.new，多数docx处理库会自行管理文件流：

  doc = Docx::Document.new(TEMPLATE_PATH)
  # 执行书签替换逻辑
  doc.save('output.docx')
  

  手动读取文件内容再传入parse，可能破坏库内部的文件生命周期管理，导致后续close调用找不到有效对象。

• 排查close调用的上下文
  定位触发错误的代码行，确认是对哪个对象调用了close。如果是手动打开的文件对象，需确保打开成功后再执行关闭操作：

  file = File.open(TEMPLATE_PATH)
  if file
    doc = Docx::Document.parse(file)
    # 业务逻辑处理
    file.close
  else
    puts "Failed to open template file"
  end
  

• 检查文件权限
  确认运行程序的用户对模板文件拥有读取权限，权限不足会导致文件打开操作返回nil，进而触发close方法调用错误。

内容的提问来源于stack exchange，提问作者Giordano Díaz