Tabelleneintrag ist nil / Index ein nil-Wert (Feld): FiveM Lua Behebung

Zwei Fehler, die ähnlich aussehen, kommen ständig in FiveM-Skripten vor:

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')

Sie bedeuten verschiedene Dinge. Der erste handelt von einem nil Schlüssel, der zweite über eine nil Tabelle. Beide kommen darauf an, dass ein Wert, den dein Code erwartete, nicht gefunden wurde. Dieser Leitfaden zeigt, wie man sie auseinanderhält und wie man den Zugriff schreibt, damit er nicht crashen kann.

#Tabelleneintrag ist nil

Du hast einer Tabelle zugewiesen, und der Schlüssel war nil:

local cache = {}

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

Lua erlaubt jeden Wert als Schlüssel außer nil (und NaN). Das Lesen von cache[nil] gibt einfach nil, aber Schreiben dazu hebt den Fehler auf.

Finde, welche Variable zwischen den Klammern nil auf dieser Zeile ist. Die üblichen Quellen:

• Ein Spieler-Lookup, der nichts zurückgab. GetPlayerIdentifierByType(source, 'license') gibt nil zurück, wenn der Spieler keinen Identifier dieses Typs hat, zum Beispiel wenn der Spieler sich nicht über die Plattform verbindet, die du erwartest.
• Ein falscher source. Auf dem Server überprüfe, dass das Event wirklich von einem Spieler kommt. Ein Aufruf aus der Konsole hat keinen Spieler dahinter.
• Ein fehlendes Feld in den Daten: data.id ist nil, weil der Sender data.Id verwendet.

Drucke es, um sicher zu sein:

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

Dann stoppa die Zuweisung, wenn der Schlüssel fehlt, und entscheide, ob das ein Fehler oder ein normaler Fall ist:

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

#Versuche, einen nil-Wert zu indexieren (Feld 'x')

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

Hier fehlt die Tabelle. Der Name in Klammern ist das Feld, das nil war, und das Ding, das du indexierst, ist auf der Zeile:

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

Lua benennt, was es weiß. Ein Paar Formen, die du sehen wirst:

Für field '?' kann Lua den Schlüssel nicht benennen, weil er berechnet ist:

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

Die Behebung ist die gleiche: Finde, welcher Schritt der Kette nil ist. Drucke jeden Schritt:

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

#Verschachtelte Config-Tabellen

Die meisten dieser Fehler kommen von Config-Dateien:

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

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

Wenn shopName 'Bar' anstelle von 'bar' ist, ist Config.Shops[shopName] nil und der nächste .items crasht. Ursachen zu überprüfen:

1. Unterschiedliche Schreibweise oder Großschreibung. Lua-Schlüssel sind case-sensitiv.
2. Die Config-Datei wird nicht geladen. Sie muss in shared_scripts (oder die richtige Liste) von fxmanifest.lua sein, bevor die Datei, die sie liest.
3. Die Config wird nur auf einer Seite definiert. Eine Datei, die unter server_scripts aufgelistet ist, ist für den Client unsichtbar.
4. Ein numerischer Schlüssel gegen einen String-Schlüssel. Config.Shops[1] und Config.Shops['1'] sind verschiedene Einträge. Das passiert oft, nachdem Daten durch JSON gehen, siehe FiveM json.decode errors.

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

#Sichere Zugriffsmuster

Wenn ein fehlender Wert ein normaler Fall ist, schreibe den Zugriff so, dass er ihn bearbeitet.

Überprüfe jeden Schritt mit 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)

Verwende or für eine Voreinstellung:

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

Mache einen kleinen Helfer, wenn du tiefe Pfade oft liest:

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')

Achtung: Verstecke nicht jeden nil mit or {}. Wenn eine Tabelle, die existieren muss, fehlt, ist das ein Bug in der Config oder der Load-Reihenfolge, und ein quiet Fallback bewegt den Fehler nur an eine weniger offensichtliche Stelle. Verwende Bewachungen für Werte, die legitim abwesend sein können.

#Dump eine Tabelle, um zu sehen, was darin ist

Wenn du nicht sicher bist, was eine Tabelle hält, drucke sie als JSON:

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

Du wirst die echten Schlüssel sehen und einen Tippfehler, eine andere Großschreibung oder eine Zahl, wo du einen String erwartest, entdecken. Mache es an dem Punkt, wo der Fehler passiert, nicht am Anfang der Datei, weil die Daten später gefüllt sein können.

#Checkliste

Für die anderen häufigen nil Meldungen, siehe attempt to compare nil und bad argument errors.