índice de tabela é nil / índice um valor nil (campo): correção FiveM Lua

Dois erros que parecem iguais surgem o tempo todo em scripts FiveM:

SCRIPT ERROR: @my_script/server/main.lua:42: table index is nil
SCRIPT ERROR: @my_script/client/main.lua:19: attempt to index a nil value (field 'shops')

Eles significam coisas diferentes. O primeiro é sobre uma chave nil, o segundo sobre uma tabela nil. Ambos se resumem a um valor que seu código esperava e não encontrou. Este guia mostra como distingui-los e como escrever o acesso para que não consiga travar.

#índice de tabela é nil

Você atribuiu a uma tabela, e a chave era nil:

local cache = {}

local function remember(identifier, data)
    cache[identifier] = data     -- table index is nil when identifier is nil
end

Lua permite qualquer valor como chave exceto nil (e NaN). Ler cache[nil] apenas dá nil, mas escrever em uma levanta o erro.

Encontre qual variável entre os colchetes é nil naquela linha. As fontes usuais:

• Uma busca de jogador que retornou nada. GetPlayerIdentifierByType(source, 'license') retorna nil quando o jogador não tem identificador desse tipo, por exemplo quando o jogador não está conectado através da plataforma que você espera.
• Um source errado. No servidor, verifique se o evento realmente vem de um jogador. Uma chamada do console não tem jogador por trás disso.
• Um campo faltando nos dados: data.id é nil porque o remetente usou data.Id.

Imprima para ter certeza:

print('identifier', identifier, type(identifier))

Então pare a atribuição quando a chave está faltando, e decida se isso é um erro ou um caso normal:

local function remember(identifier, data)
    if not identifier then
        return print('remember: no identifier, skipping')
    end
    cache[identifier] = data
end

#tentativa de indexar um valor nil (campo 'x')

attempt to index a nil value (field 'shops')

Aqui a tabela está faltando. O nome entre colchetes é o campo que era nil, e a coisa que você indexou é na linha:

local first = Config.shops[1]    -- Config.shops is nil, so [1] fails

Lua nomeia o que sabe. Algumas formas que você verá:

Para field '?', Lua não consegue nomear a chave porque é computada:

Config.Shops[id].label          -- attempt to index a nil value (field '?')

A correção é a mesma: encontre qual passo da cadeia é nil. Imprima cada passo:

print(Config)
print(Config.Shops)
print(Config.Shops[id])

#Tabelas config aninhadas

A maioria desses erros vêm de arquivos de config:

Config = {}
Config.Shops = {
    bar = { label = 'Bar', items = { 'beer', 'water' } },
}

-- somewhere else
local items = Config.Shops[shopName].items

Se shopName é 'Bar' em vez de 'bar', Config.Shops[shopName] é nil e o próximo .items trava. Causas a verificar:

1. Ortografia ou caso diferente. Chaves de Lua são sensíveis a caso.
2. O arquivo config não é carregado. Deve estar em shared_scripts (ou a lista do lado certo) de fxmanifest.lua, antes do arquivo que o lê.
3. O config é definido em um lado apenas. Um arquivo listado sob server_scripts é invisível para o cliente.
4. Uma chave numérica contra uma chave de string. Config.Shops[1] e Config.Shops['1'] são entradas diferentes. Isso frequentemente acontece após dados passar através de JSON, veja erros FiveM json.decode.

-- fxmanifest.lua
shared_scripts { 'config.lua' }
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

#Padrões de acesso seguro

Quando um valor faltando é um caso normal, escreva o acesso para lidar com isso.

Verifique cada passo com and:

local shop = Config.Shops and Config.Shops[shopName]
if not shop then
    return print(('Unknown shop: %s'):format(tostring(shopName)))
end
print(shop.label)

Use or para um padrão:

local items = (shop and shop.items) or {}
local radius = Config.Radius or 5.0

Faça um pequeno ajudante quando você lê caminhos profundos frequentemente:

local function get(t, ...)
    for _, key in ipairs({ ... }) do
        if type(t) ~= 'table' then return nil end
        t = t[key]
    end
    return t
end

local label = get(Config, 'Shops', shopName, 'label')

Atenção: não oculte cada nil com or {}. Se uma tabela que deve existir está faltando, isso é um bug no config ou na ordem de carga, e um fallback silencioso apenas move o erro para algum lugar menos óbvio. Use guardas para valores que podem legitimamente estar ausentes.

#Despeje uma tabela para ver o que está dentro

Quando você não tem certeza do que uma tabela contém, imprima-a como JSON:

print(json.encode(Config.Shops, { indent = true }))

Você verá as chaves reais e verá um erro de digitação, um caso diferente ou um número onde você esperava uma string. Faça isso no ponto onde o erro acontece, não no topo do arquivo, porque os dados podem ser preenchidos depois.

#Checklist

Para as outras mensagens nil comuns, veja tentar comparar nil e erros de argumento inválido.