ChefSpec运行Nginx Cookbook测试报错：undefined method `[]' for nil:NilClass

这是ChefSpec单元测试里很常见的问题——毕竟Kitchen是完整的集成测试环境，会自动加载依赖Cookbook的属性和资源，但ChefSpec是孤立运行的，不会自动处理这些依赖。我来帮你一步步排查解决：

1. 先定位错误的具体代码 #

打开nginx/recipes/_configure.rb第23行，找到触发报错的代码。大概率是类似这样的写法：

target_value = node['nginx']['some_config']['sub_item']

这里的问题是node['nginx']['some_config']是nil，所以调用[]方法时直接抛出了错误。

2. 在ChefSpec测试中补充缺失的属性 #

ChefSpec会加载Cookbook自身的默认属性，但如果你的Nginx Cookbook依赖bar Cookbook设置的属性，或者某些属性层级没有默认值，就需要手动在测试里初始化。修改你的测试文件：

require 'chefspec'

describe 'nginx::default' do
  let(:chef_run) do
    ChefSpec::SoloRunner.new(platform: 'ubuntu', version: '20.04') do |node|
      # 根据第23行的错误，补充对应的属性层级
      node.normal['nginx']['some_config'] = { 'sub_item' => 'default_test_value' }
      # 如果依赖bar Cookbook的属性，也需要在这里同步设置
      node.normal['bar']['required_attr'] = 'test_value'
    end.converge(described_recipe)
  end

  it 'converges successfully' do
    expect { chef_run }.to_not raise_error
  end
end

3. Stub依赖的Cookbook资源 #

如果Nginx Cookbook的运行依赖bar Cookbook的recipe执行（比如bar会创建某个关键资源或设置全局属性），你需要在测试里stub这些依赖，避免ChefSpec尝试加载未包含的Cookbook：

before do
  # Stub bar Cookbook的recipe引用，避免实际执行
  allow_any_instance_of(Chef::Recipe).to receive(:include_recipe).with('bar::default')
  # 如果有版本依赖，也可以指定Cookbook版本
  stub_cookbook('bar', '2.1.0')
end

4. 完善Cookbook的默认属性（可选但推荐） #

为了避免后续测试或生产环境再出现类似问题，建议在Nginx Cookbook的attributes/default.rb中为关键属性设置默认值，确保属性层级不会为nil：

# 先初始化顶层哈希，避免后续访问子属性时出现nil
default['nginx']['some_config'] = {}
default['nginx']['some_config']['sub_item'] = 'production_default_value'

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