bad argument #1 to 'X' (number expected, got nil): FiveM Lua исправление

Где-то в вашей консоли, скрипт останавливается с этим:

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

Функция была вызвана с аргументом, который она не может использовать, и аргумент почти всегда nil. Сообщение говорит вам, какая функция, какой аргумент и какой тип ей требуется. Это руководство показывает, как его читать и обычные источники nil.

#Как прочитать сообщение

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

• X — это имя функции, которая пожаловалась.
• #1 — это позиция аргумента: #1 — первый, #2 — второй.
• number expected — это тип, который требует функция. Это может также сказать string, table или boolean.
• got nil — это то, что она действительно получила. Это может также быть got table, got string или got no value.

Откройте строку из ошибки и посмотрите на функцию, названную в сообщении. Затем посмотрите на аргумент в той позиции и спросите, откуда она берётся.

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

Здесь Config.Prices[item] это nil, потому что item не является ключом таблицы. Ошибка находится в строке math.floor, но ошибка в данных.

#table expected, got nil

То же сообщение с таблицей появляется с функциями table:

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

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

Создайте таблицу перед её использованием:

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

Для таблицы, которая находится в общей структуре, создайте её, когда она отсутствует:

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

#Перебор nil: pairs и ipairs

В Lua 5.3 и 5.4, которые использует FiveM, перебор nil не удаётся с сообщением, которое называет цикл вместо pairs:

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

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

Проверьте, где определена таблица: опечатка в имени, файл конфигурации не загруженный манифестом или данные, которые ещё не поступили. Короткий охранник избегает краха, пока вы найдёте реальную причину:

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

Используйте это как страховку, а не как исправление. Если Config.Jobs должна существовать, пустой цикл только скрывает ошибку. Связанное сообщение table index is nil охватывает отсутствующие ключи в вложенных таблицах конфиг.

#Нативные, которые получают nil

Многие нативные нуждаются в числе, такие как дескриптор сущности. Дескриптор, который nil или 0, обычно означает, что сущность не существует (ещё).

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

Частые источники:

• Сущность не загружена. Автомобиль, спауненный сервером, недоступен для вашего клиента на мгновение. На клиенте, дождитесь его существования:

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

• Функция ничего не вернула. GetPlayerPed(-1), GetClosestVehicle и подобные могут вернуть 0, когда ничего не совпадает. Проверьте значение перед его использованием.
• Неправильный вектор. Нативный, который хочет три числа, x, y, z, не принимает всю таблицу. Передайте coords.x, coords.y, coords.z или используйте vector3, где нативный берёт один.
• Отсутствующий ключ в конфиге. Config.Spawn.x это nil когда Config.Spawn написан с [1], [2], [3].

Точный текст зависит от нативного, и некоторые нативные вообще не вызывают ошибку, но ничего не делают. Вот почему охранник стоит добавить:

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

#tostring, tonumber и string.format

Функции преобразования — это ещё один источник nil:

• tonumber('abc') возвращает nil, а не ошибку, поэтому краш приходит позже, когда вы используете результат.
• tostring(value) всегда возвращает строку, даже для nil (это даёт 'nil'), поэтому это безопасно использовать при построении текста.
• string.format('%d', value) не удаётся когда value это nil: bad argument #2 to 'format' (number expected, got nil).

Когда число поступает от игрока или из команды, проверьте его:

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)

Обратите внимание, что args[1] это nil, когда игрок напечатал /pay один, и tonumber(nil) возвращает nil, поэтому проверка выше охватывает оба случая.

#Найдите nil

Когда источник не очевиден, выведите значения прямо перед неудачной строкой:

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

Затем трассируйте nil обратно к месту, где она должна была быть установлена. Удалите выводы, когда закончите.

#Чеклист

Если ошибка о чём-то, что является nil вместо плохого аргумента, прочитайте attempt to compare nil и attempt to call a nil value.