bad argument #1 to 'X' (number expected, got nil): naprawa Lua FiveM

Gdzieś w twojej konsoli skrypt zatrzymuje się z tym:

SCRIPT ERROR: @my_script/client/main.lua:57: bad argument #1 to 'floor' (number expected, got nil)

Funkcja została wezwana z argumentem, którego nie może używać, a argument to prawie zawsze nil. Wiadomość mówi ci, która funkcja, który argument i jaki typ chciała. Ten przewodnik pokazuje, jak go przeczytać i zwyczajne źródła nil.

#Jak przeczytać wiadomość

bad argument #1 to 'X' (number expected, got nil)

• X to nazwa funkcji, która się poskarżyła.
• #1 to pozycja argumentu: #1 to pierwszy, #2 to drugi.
• number expected to typ, który funkcja potrzebuje. Może również mówić string, table lub boolean.
• got nil to to, co naprawdę otrzymała. Może być got table, got string lub got no value.

Otwórz linię z błędu i poszukaj funkcji wymienionej w wiadomości. Następnie spójrz na argument w tej pozycji i zapytaj, skąd to pochodzi.

local price = Config.Prices[item]
local rounded = math.floor(price)   -- bad argument #1 to 'floor' (number expected, got nil)

Tutaj Config.Prices[item] jest nil, ponieważ item nie jest kluczem tabeli. Błąd jest na linii math.floor, ale błąd jest w danych.

#table expected, got nil

Ta sama wiadomość z tabelą pojawia się z funkcjami table:

bad argument #1 to 'insert' (table expected, got nil)

local list
table.insert(list, 'a')     -- list was never created

Utwórz tabelę, zanim jej użyjesz:

local list = {}
table.insert(list, 'a')

Dla tabeli, która żyje w wspólnej strukturze, utwórz ją, gdy brakuje:

players[source] = players[source] or {}
table.insert(players[source], item)

#Pętla nad nil: pairs i ipairs

W Lua 5.3 i 5.4, które FiveM używa, pętla nad nil zawala się z wiadomością, która wymienia pętlę zamiast pairs:

bad argument #1 to 'for iterator' (table expected, got nil)

for _, job in pairs(Config.Jobs) do   -- Config.Jobs is nil

Sprawdzaj, gdzie tabela jest zdefiniowana: literówka w nazwie, plik config nie załadowany przez manifest, lub dane, które nie przybyły jeszcze. Krótka osłona unika awarii, gdy znajdziesz prawdziwą przyczynę:

for _, job in pairs(Config.Jobs or {}) do

Używaj tego jako sieci bezpieczeństwa, a nie jako naprawę. Jeśli Config.Jobs powinno istnieć, pusta pętla tylko ukrywa błąd. Powiązana wiadomość table index is nil obejmuje brakujące klucze w zagnieżdżonych tabelach config.

#Natives, które otrzymują nil

Wiele natives potrzebuje liczby, takie jak uchwyt encji. Uchwyt, który jest nil lub 0, zwykle oznacza, że encja nie istnieje (jeszcze).

local vehicle = GetVehiclePedIsIn(ped, false)
local plate = GetVehicleNumberPlateText(vehicle)   -- vehicle is 0 when the ped is on foot

Zwyczajne źródła:

• Encja nie jest załadowana. Pojazd spawniętny przez serwer nie jest dostępny dla twojego klienta na moment. Na kliencie czekaj, aż będzie istnieć:

local vehicle = NetToVeh(netId)
local timeout = 0
while not DoesEntityExist(vehicle) and timeout < 100 do
    Wait(50)
    vehicle = NetToVeh(netId)
    timeout = timeout + 1
end

• Funkcja nic nie zwróciła. GetPlayerPed(-1), GetClosestVehicle i podobne mogą zwrócić 0, gdy nic się nie zgadza. Sprawdzaj wartość, zanim jej użyjesz.
• Zły wektor. Native, który chce trzy liczby, x, y, z, nie akceptuje całej tabeli. Przekaż coords.x, coords.y, coords.z, lub użyj vector3, gdzie native przyjmuje jeden.
• Brakujący klucz w config. Config.Spawn.x jest nil, gdy Config.Spawn jest napisane z [1], [2], [3].

Dokładny tekst zależy od native, a niektóre natives nie podnoszą błędu w ogóle, ale nic nie robią. Dlatego warto dodać osłonę:

if vehicle ~= 0 and DoesEntityExist(vehicle) then
    SetVehicleEngineOn(vehicle, true, true, false)
end

#tostring, tonumber i string.format

Funkcje konwersji to inne źródła nil:

• tonumber('abc') zwraca nil, a nie błąd, więc awaria pojawia się później, gdy używasz wyniku.
• tostring(value) zawsze zwraca string, nawet dla nil (daje 'nil'), więc jest bezpieczne użyć, gdy budujesz tekst.
• string.format('%d', value) zawala się, gdy value jest nil: bad argument #2 to 'format' (number expected, got nil).

Gdy liczba pochodzi od gracza lub z polecenia, sprawdzaj ją:

RegisterCommand('pay', function(source, args)
    local amount = tonumber(args[1])
    if not amount then
        return print('Usage: /pay [amount]')
    end
    print(('Paying %d'):format(amount))
end)

Zanotuj args[1] to nil, gdy gracz wpisał /pay sam, a tonumber(nil) zwraca nil, więc powyższa kontrola obejmuje oba przypadki.

#Znajdź nil

Gdy źródło nie jest oczywiste, wydrukuj wartości zaraz przed linią niepowodzenia:

print('item', item, type(item))
print('price', Config.Prices[item], type(Config.Prices[item]))

Następnie śledź nil wstecz do miejsca, gdzie powinno być ustawione. Usuń wydruki, gdy skończysz.

#Lista kontrolna

Jeśli błąd dotyczy czegoś, czego brakuje, zamiast złego argumentu, przeczytaj attempt to compare nil i attempt to call a nil value.