Błąd json.decode w FiveM: naprawy dla nil, pustych stringów i nieważnego JSON

Błąd pojawia się jeden wiersz po dekodowaniu:

SCRIPT ERROR: @my_script/server/main.lua:31: attempt to index a nil value (local 'data')

local data = json.decode(row.metadata)
print(data.level)   -- data is nil

json.decode nie dał Ci nic użytecznego, więc następna linia zaindeksowała nil. Dekodowanie rzadko jest rzeczywistym błędem. Dane wejściowe były nil, puste lub zniszczone, lub tabela, którą zapisałeś wcześniej nie była tym, co myślałeś. Tutaj dowiesz się jak znaleźć który przypadek i jak dekodować bezpiecznie.

#1. String to nil lub pusty

Najczęstszy przypadek. Wartość, którą dekoddujesz nie istnieje jeszcze:

• Kolumna bazy danych, która jest NULL. Wiersz bez zapisanych danych zwraca nil dla tej kolumny.
• Zapytanie bez wyniku. MySQL.scalar.await(...) i MySQL.single.await(...) zwracają nil gdy żaden wiersz się nie zgadza. Zajrzyj do oxmysql queries guide aby dowiedzieć się co każda funkcja zwraca.
• Klucz KVP, który nigdy nie był ustawiony. GetResourceKvpString('my_key') zwraca nil gdy klucz nie istnieje, zobacz FiveM resource KVP.
• Plik, który brakuje. LoadResourceFile(GetCurrentResourceName(), 'data.json') zwraca nil gdy plik tam nie jest.
• Pusty string. Kolumna zapisana jako '' nie jest także ważnym JSON.

Dekodowanie nil lub '' to błąd w wywołującym, więc sprawdź string najpierw:

local raw = GetResourceKvpString('my_key')
local data = {}

if raw and raw ~= '' then
    data = json.decode(raw) or {}
end

#2. JSON jest nieważny

String, który jest obecny, może być wciąż nieważny. Typowe przyczyny gdy plik lub wartość bazy danych była edytowana ręcznie:

• Przecinek na końcu po ostatnim wpisie: { "a": 1, }
• Cudzysłowy jednokrotne zamiast podwójnych: { 'a': 1 }
• Komentarze w pliku. JSON ich nie pozwala.
• Brakujący nawias lub cudzysłów po skopiowaniu części pliku.
• Składnia Lua wklejona do pliku JSON, taka jak a = 1 lub [1] = 'x'.
• Zły znak z edytora tekstu, taki jak krzywe cudzysłowy skopiowane ze strony internetowej.

{
  "items": [
    { "name": "water", "count": 2 },
    { "name": "bread", "count": 1 }
  ]
}

Sprawdź plik przed tym, zanim obwinisz skrypt. VS Code podkreśla błędy JSON podczas pisania, a internetowy walidator JSON pokazuje dokładną pozycję błędu.

#3. Zawsze dekoduj z pcall

W zależności od danych wejściowych i buildu, zły string albo podnosi błąd Lua, albo wraca jako nil. Nie musisz pamiętać które: opatrz wywołanie aby obsługiwane były oba.

local function safeDecode(str)
    if type(str) ~= 'string' or str == '' then
        return nil
    end

    local ok, result = pcall(json.decode, str)
    if not ok or type(result) ~= 'table' then
        return nil
    end

    return result
end

local data = safeDecode(row.metadata) or {}
print(data.level)

Sprawdzenie type(result) ~= 'table' również chwyta wartość, która jest ważnym JSON ale nie obiektem, taką jak "hello" lub 5.

Wskazówka: gdy dekodowanie nie powiedzie się i nie wiesz dlaczego, wypisz surowy string obok jego typu: print(type(str), str). A nil lub pusta linia pokazuje przyczynę od razu.

#4. json.encode i klucze, które się zmieniają

Dekodowanie może się powieść i wciąż dać Ci niepoprawne dane, ponieważ tabela została zapisana w formie, która nie przetrwa tam i z powrotem. JSON ma dwa kształty: listę [...] i obiekt {...} z tekstowymi kluczami.

local saved = json.encode({ [100] = 'a', [250] = 'b' })
local loaded = json.decode(saved)

print(loaded[100])     -- nil
print(loaded['100'])   -- 'a'

Co to znaczy w praktyce:

• Klucze liczbowe stają się kluczami tekstowymi gdy tabela jest zapisana jako obiekt. Po dekodowaniu, poszukaj wartości za pomocą tekstowego klucza, lub konwertuj klucz z tonumber.
• Rzadkie tablice z dziurami ({ [1] = 'a', [3] = 'c' }) nie są czystą listą, więc mogą być napisane jako obiekt zamiast tablicy.
• Mieszane tabele, zarówno z elementami listy jak i nazwanymi kluczami, nie mapują się czysty do żadnego kształtu. Przechowuj listę jako listę, i umieść nazwane pola w osobnej tabeli.
• Funkcje, userdata i wektory nie mogą być napisane jako zwykłe dane JSON. Konwertuj wektor do { x = v.x, y = v.y, z = v.z } przed enkodowaniem.
• Pusta tabela jest zwykle napisana jako [], więc przeczytaj ją z powrotem jako listę lub pustą tabelę, nie jako obiekt.

Bezpieczny sposób na przechowywanie współrzędnych:

-- save
local payload = json.encode({ x = coords.x, y = coords.y, z = coords.z })

-- load
local pos = safeDecode(payload)
if pos then
    SetEntityCoords(ped, pos.x, pos.y, pos.z, false, false, false, false)
end

Użyj json.encode(value, { indent = true }) podczas debugowania, ponieważ jest to o wiele łatwiejsze do przeczytania.

#5. Dekoduj raz i sprawdzaj typ

Dane z bazy danych mogą dotrzeć do Twojego skryptu jako string w jednym miejscu i jako tabela w innym. Niektóre biblioteki i frameworki dekodują dla Ciebie kolumny JSON, inne zwracają surowy tekst. Zanim dekoddujesz, sprawdzaj co przechowujesz:

local meta = row.metadata
if type(meta) == 'string' then
    meta = safeDecode(meta)
end
meta = meta or {}

Dekodowanie czegoś, co już jest tabelą, to błąd, a sprawdzenie typu nic nie kosztuje.

#Checklist