Tóm tắt
Mở cửa sổ Output qua menu Window hoặc tab Script, bấm Play và click vào lỗi màu đỏ đầu tiên. Studio sẽ mở script ở đúng dòng bị lỗi. Thông báo cho biết điều gì đã sai: attempt to index nil with 'Humanoid' nghĩa là giá trị ngay trước .Humanoid là nil. Hãy sửa lý do khiến giá trị đó không có, rồi chạy game lại.
- Bắt đầu từ lỗi đầu tiên trong danh sách. Các lỗi bên dưới thường chỉ là hệ quả của nó.
- Các lỗi hay gặp lúc chạy game quy về ba nguyên nhân: một giá trị là
nil, một cái tên bị viết sai hoặc chưa tải xong, hoặc code chạy sai phía (server hay client). - Nếu hoàn toàn không có lỗi, thường là code chưa hề chạy. Kiểm tra loại script, vị trí của nó trong Explorer, thuộc tính
Enabledcủa nó, và sự kiện mà nó chờ có thực sự xảy ra không. - Để biết thật sự một giá trị bằng gì ở dòng cần xem, hãy in nó ra bằng print kèm nhãn hoặc đặt breakpoint ở dòng đó.
Trong trang này
Cách mở Output và đọc một lỗi
Cửa sổ Output là nơi Roblox báo lỗi script, cảnh báo của engine và mọi thứ code của bạn in ra. Nó không phải lúc nào cũng mở sẵn, nên hãy mở nó trước khi test. Nếu bạn chưa từng chạy script nào, hướng dẫn học script cho người mới bắt đầu bằng việc mở Output và in dòng đầu tiên từ một script.
- Mở Output qua menu Window trong Studio hoặc bằng nút trên tab Script.
- Xóa các thông báo cũ bằng Ctrl+K (⌘K trên Mac), để chỉ thấy lần test này.
- Bấm Play (F5) và làm đúng việc khiến game bị hỏng.
- Tìm dòng màu đỏ đầu tiên. Lỗi có màu đỏ. Cảnh báo, ví dụ
Infinite yield possible, hiện màu cam.
Một lỗi lúc chạy game trong Output trông như thế này. Tùy cài đặt hiển thị của Output, mỗi dòng còn có thể có thời gian, nhãn Client hoặc Server và tên script.
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
ServerScriptService.CoinPadlà vị trí của script trong Explorer: một script tên CoinPad bên trong ServerScriptService.:14là dòng xảy ra lỗi.- Thông báo sau số dòng cho biết điều gì đã sai. Mỗi thông báo được giải thích trong danh sách lỗi hay gặp bên dưới.
- Stack giữa Stack Begin và Stack End cho thấy các lệnh gọi dẫn tới đây, bắt đầu từ lệnh gần nhất: dòng 14 bên trong hàm
award, được gọi từ dòng 27.
Click vào lỗi màu đỏ, và Studio mở script đó với con trỏ ở đúng dòng. Khi test một mình, thông báo của server và client của bạn cùng vào một Output: thông báo server có nhãn màu xanh lá, thông báo client màu xanh dương. Các bộ lọc ở trên thu hẹp danh sách theo loại thông báo (Error, Warning), theo ngữ cảnh (Client, Server) hoặc theo chữ.
Trình tự gỡ lỗi dùng được cho mọi script
Đoán mò và đổi nhiều thứ cùng lúc là cách sửa script chậm nhất. Trình tự này thu hẹp vấn đề từng bước một, dù có thông báo lỗi hay không.
- Tái hiện vấn đề. Xóa Output, bấm Play và làm đúng việc khiến game bị hỏng. Ghi lại bạn mong đợi điều gì và điều gì đã xảy ra thay vào đó.
- Lấy lỗi đầu tiên. Đọc dòng đỏ mới đầu tiên: đường dẫn script, số dòng và thông báo. Nếu không có lỗi, chuyển tới phần script chạy mà không báo lỗi.
- Tới đúng dòng. Click vào lỗi. Đọc cả dòng và tự hỏi giá trị nào trong đó có thể là
nil, bị viết sai hoặc sai kiểu. - Kiểm tra giá trị, đừng đoán. Thêm một
printngay phía trên dòng đó hoặc đặt breakpoint trên nó và xem giá trị trong cửa sổ Watch.typeof(x)cho biết bạn đang có gì: số, string, Instance hay nil. - Lần ngược dấu vết. Nếu giá trị sai, tìm nơi nó được gán: một
FindFirstChildkhông tìm thấy gì, một hàm không trả về gì, một đối số mà code gọi hàm chưa bao giờ truyền vào. - Sửa nguyên nhân, mỗi lần một thay đổi. Sửa tên, chờ object hoặc chuyển code sang đúng phía, rồi chạy game lại. Đừng bọc dòng đó trong
pcallđể nó im lặng: làm vậy là giấu bug chứ không sửa bug. - Xác nhận. Lặp lại bước 1. Lỗi phải biến mất, và tính năng phải làm đúng điều bạn mong đợi. Nếu liên quan tới người chơi khác, hãy test thêm ở chế độ Server & Clients với hai client.
- Dọn dẹp. Xóa hoặc tắt các print gỡ lỗi, để vấn đề tiếp theo dễ thấy.
Các lỗi script Roblox hay gặp và cách sửa
Mỗi thông báo theo một mẫu cố định có điền tên của bạn vào, nên bản thân nội dung lỗi là gợi ý tốt nhất. Các tên trong ngoặc kép bên dưới, ví dụ 'Health' hay "Workspace", chỉ là ví dụ.
| Output viết gì | Nghĩa là gì | Cách sửa thường gặp |
|---|---|---|
attempt to index nil with 'Health' | Giá trị trước .Health là nil. | Tìm hiểu vì sao nó là nil, và kiểm tra nó bằng if trước khi dùng. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild đã chờ 5 giây mà object vẫn chưa xuất hiện. | Sửa tên hoặc đường dẫn, đảm bảo có thứ gì đó tạo ra object, hoặc thêm timeout. |
Bridge is not a valid member of Workspace "Workspace" | Hiện không có object con hay thuộc tính nào với đúng tên đó ở đó. | Đối chiếu cách viết và chữ hoa với Explorer. Trên client hãy dùng WaitForChild. |
attempt to call a nil value | Bạn đã gọi một thứ không phải là hàm. | Kiểm tra tên hàm và việc nó được khai báo phía trên lệnh gọi. |
attempt to perform arithmetic (add) on Instance and number | Làm toán với một thứ không phải số. | Dùng .Value với value object và tonumber với chữ. |
attempt to concatenate string with nil | .. cố nối chữ với nil hoặc một object. | Dùng tostring(), .Name hoặc nội suy chuỗi. |
Expected 'end' (to close 'function' at line 3), got <eof> | Lỗi cú pháp. Script hoàn toàn không chạy. | Sửa chỗ bị gạch đỏ trong Script Editor. |
Requested module experienced an error while loading | Chính ModuleScript bị lỗi trong lúc chạy. | Sửa lỗi riêng của module, nó hiện ngay phía trên trong Output. |
Argument 1 missing or nil | Một hàm Roblox nhận nil ở chỗ nó cần một giá trị. | Lần theo nơi mà đối số đó lẽ ra phải tới từ đó. |
FireServer can only be called from the client | RemoteEvent bị gọi từ sai phía. | Server dùng FireClient, LocalScript dùng FireServer. |
Lỗi DataStore 403, StudioAccessToApisNotAllowed | Studio không được phép dùng DataStore của game này. | Publish game và bật Studio Access to API Services. |
Mỗi thông báo ở đây, và cả những thông báo khác, đều có trang riêng với từng nguyên nhân, đoạn code gây ra nó và cách sửa: xem các thông báo lỗi của Roblox Studio, ví dụ attempt to index nil, Infinite yield possible và is not a valid member of.
attempt to index nil with 'X'
Index là việc đọc một thứ qua dấu chấm hoặc dấu ngoặc vuông: part.Position, player.Character, list[1]. Lỗi này cho biết thứ ở bên trái là nil, còn cái tên trong ngoặc kép là thứ bạn cố đọc từ nó. Vậy trên dòng player.Character.Humanoid, lỗi attempt to index nil with 'Humanoid' nghĩa là player.Character là nil. Nếu key là một số, thông báo kết thúc bằng with number.
Các lý do thường gặp khiến giá trị là nil:
FindFirstChild,FindFirstChildOfClasshoặcFindFirstAncestorkhông tìm thấy gì, vì tên khác hoặc object chưa có.Players.LocalPlayerbị dùng trong một Script server. Nó chỉ có trong LocalScript và trong ModuleScript mà chúng require; trên server nó luôn là nil. Thay vào đó hãy dùngplayermàPlayerAddedhoặc hàm xử lý RemoteEvent cung cấp.player.Characterbị đọc trước khi nhân vật spawn, hoặc trong lúc nó đang respawn.- Một mục trong bảng chưa bao giờ được gán, ví dụ
playerData[player]trước khi dữ liệu của người chơi đó tải xong, hoặc hàm được gọi không trả về gì.
Trường hợp kinh điển là khối giết người. Bản bị hỏng cho rằng mọi thứ chạm vào part đều thuộc về một nhân vật, nhưng với tool bị vứt ra, part chưa Anchored và phụ kiện thì không phải vậy.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Bản bị hỏng:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Nếu part chạm vào không phải một phần cơ thể nhân vật, FindFirstChild
-- trả về nil, và Output hiện:
-- attempt to index nil with 'Health'
-- Đã sửa: kiểm tra từng bước trước khi dùng
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Nếu viết hit.Parent.Humanoid, bạn sẽ nhận một thông báo khác, Humanoid is not a valid member of ..., được giải thích bên dưới. FindFirstAncestorOfClass("Model") tìm ra nhân vật cả khi part chạm vào nằm trong phụ kiện hoặc trong tool nhân vật đang cầm, nên tool đang cầm chạm vào khối cũng được tính.
Mẫu sửa lỗi này: lấy giá trị, kiểm tra nó, rồi mới dùng. Trên server, FindFirstChild kèm kiểm tra if phù hợp với những thứ có thể không tồn tại. Trong LocalScript, dùng WaitForChild cho những thứ server tạo ra, vì chúng có thể xuất hiện sau khi script đã chạy.
Infinite yield possible on ...
WaitForChild("Name") tạm dừng script cho tới khi xuất hiện một object con có tên đó. Nếu nó chờ quá 5 giây mà bạn không đặt timeout, Roblox in ra cảnh báo này. Đây là cảnh báo, không phải lỗi: script vẫn đang chờ, và không có gì sau dòng này chạy cho tới khi object xuất hiện, mà điều đó có thể không bao giờ xảy ra. Các nguyên nhân thường gặp:
- Sai tên hoặc sai parent.
WaitForChild("leaderStats")sẽ không bao giờ tìm thấy folderleaderstats. - Không có gì tạo ra object: script server tạo nó bị tắt, nằm sai chỗ hoặc đã lỗi trước đó. Hãy tìm lỗi sớm hơn trong Output.
- LocalScript chờ thứ gì đó trong ServerStorage hoặc ServerScriptService. Nội dung của chúng không bao giờ được gửi tới người chơi, nên việc chờ sẽ không kết thúc.
- Bạn đang chờ một thuộc tính, không phải object con. Ví dụ hay gặp là
player:WaitForChild("Character"):Characterlà thuộc tính của Player, không phải object bên trong nó. - Instance streaming đang bật (
Workspace.StreamingEnabled), và part ở quá xa người chơi nên chưa được gửi tới client này.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Bản bị hỏng:
-- local character = player:WaitForChild("Character")
-- Character là thuộc tính của Player, không phải object con, nên Output cảnh báo:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Có timeout thì WaitForChild trả về nil thay vì chờ mãi mãi
local humanoid = character:WaitForChild("Humanoid", 10)
if not (humanoid and humanoid:IsA("Humanoid")) then
warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
return
end
humanoid.Died:Connect(function()
print(`[DeathMessage] {player.Name} died`)
end)
end
-- Xử lý nhân vật có thể đã tồn tại, rồi đến mỗi lần respawn
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
Con số làm đối số thứ hai của WaitForChild là timeout tính bằng giây. Khi đó script có thể báo vấn đề bằng warn và dừng gọn gàng, thay vì treo im lặng.
X is not a valid member of Y
Bạn đã dùng dấu chấm để truy cập một object con hoặc thuộc tính không tồn tại lúc đó, ví dụ workspace.Bridge khi trong Workspace không có part nào tên Bridge. Trong thông báo, đầu tiên là thứ bạn yêu cầu, sau đó là class và đường dẫn đầy đủ của object nơi nó được tìm. Kiểm tra ba điều:
- Cách viết và chữ hoa khớp chính xác với Explorer. Folder tên là
leaderstats, toàn chữ thường, vàhumanoidkhông phải làHumanoid. - Tên thuộc tính viết theo tiếng Anh Mỹ.
part.Colourlỗi vớiColour is not a valid member of Part "Workspace.Part"; thuộc tính tên làColor. - Object đã tải xong. Trên client, object do server tạo có thể tới sau khi LocalScript đã chạy, nên ở đó hãy dùng
WaitForChild.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Bản bị hỏng:
-- local coins = player.leaderstats.Coins
-- leaderstats do server tạo, và nó có thể tới client này sau khi
-- script này đã chạy. Khi đó Output hiện:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- server tạo Coins dạng IntValue
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Ở đây cần một script server tạo leaderstats với một IntValue tên Coins, như trong hướng dẫn bảng xếp hạng.
attempt to call a nil value
Code đặt dấu ngoặc sau một thứ bằng nil, nên không có gì để chạy. Các nguyên nhân thường gặp:
- Tên hàm bị viết sai hoặc khác chữ hoa. Module khai báo
Format.clock, còn code gọi lại viếtFormat.Clock(95). local functionbị gọi ở một dòng phía trên chỗ khai báo nó. Lúc đó tên chưa tồn tại, nên hãy dời phần khai báo lên trên.- ModuleScript không bao giờ thêm hàm vào bảng mà nó trả về.
Hai thông báo tương tự chỉ cùng một lỗi. Gọi một method không tồn tại của bảng bằng dấu hai chấm cho ra attempt to call missing method 'Kill' of table. Gõ sai method của object Roblox, ví dụ part:Destory(), cho ra Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
Luau cố làm phép tính (add, sub, mul, div và các phép khác), nhưng một vế không phải là số. Tên kiểu ở cuối thông báo cho biết bạn đang gặp trường hợp nào:
on Instance and number: bạn đã tính với value object, chứ không phải với con số của nó.coins + 10phải làcoins.Value + 10.on nil and number: biến hoặc mục trong bảng chưa bao giờ được gán. Hãy cho nó giá trị ban đầu, hoặc viết(x or 0)ở chỗ mà không có giá trị thật sự nghĩa là số không.on string and number: chữ không phải là số, thường lấy từ TextBox. Chuyển nó bằngtonumber(text)và kiểm tra kết quả không phải nil. Chữ chứa một con số, ví dụ"5", được chuyển tự động.
Phép so sánh cũng hỏng theo cách tương tự, với attempt to compare nil < number. Luau viết lại a > b thành b < a, nên thứ tự trong thông báo có thể ngược với code của bạn.
local Players = game:GetService("Players")
local REWARD = 5
local INTERVAL_SECONDS = 60
local function addCoins(player: Player, amount: number)
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
-- Ghi ra lý do không có gì xảy ra, thay vì im lặng
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Bản bị hỏng:
-- coins = coins + amount
-- coins là object IntValue, không phải con số của nó, nên Output hiện:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- Mỗi phút cho mỗi người chơi trên server một ít coin
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
Toán tử .. chỉ nối string và số. Không nối được với nil, với object cũng không: "Hi " .. player cho ra attempt to concatenate string with Instance. Hãy dùng player.Name, bọc giá trị trong tostring() hoặc dùng nội suy chuỗi với dấu backtick, print(`Coins: {coins}`), cách này sẽ in ra nil chứ không làm dừng script.
Expected 'end' và các lỗi cú pháp khác
Các thông báo bắt đầu bằng Expected là lỗi cú pháp: code không phải Luau hợp lệ, Roblox không compile được nó, và không dòng nào của script này chạy, kể cả các dòng nằm trên lỗi. Script Editor gạch đỏ chúng ngay khi bạn gõ, nên bạn có thể sửa trước khi bấm Play.
Expected 'end' (to close 'function' at line 3), got <eof>: mộtfunction,if,forhoặcwhilebắt đầu ở dòng 3 thiếuendcủa nó. Số dòng trước thông báo thường chỉ vào cuối file, nên hãy xem dòng được nêu trong ngoặc.Expected 'then' when parsing if statement, got '=': một dấu=đơn trong điều kiện. So sánh thì cần==.Expected ')' (to close '(' at line 1), got 'local': dấu ngoặc chưa bao giờ được đóng.Expected <eof>, got 'end': thừa mộtend.
Khi thụt lề đều đặn, một end bị thiếu hay bị thừa rất dễ nhận ra, vì mỗi khối thẳng hàng với end đóng nó.
Requested module experienced an error while loading
require() đầu tiên của một ModuleScript sẽ chạy code của nó. Nếu module bị lỗi trong lúc chạy, script đã require nó nhận được thông báo này. Vấn đề thật sự là lỗi riêng của module, nằm cao hơn một hai dòng trong Output: hãy sửa lỗi đó. Hai thông báo tương tự:
Module code did not return exactly one value: module không kết thúc bằngreturn. ModuleScript phải trả về đúng một giá trị, không phải nil, thường là bảng của nó.Requested module was required recursively: hai module require lẫn nhau. Hãy tách phần dùng chung ra một module thứ ba mà cả hai cùng require.
local Format = {}
-- Đổi số giây thành phút và giây: 95 thành "1:35"
function Format.clock(seconds: number): string
local whole = math.max(0, math.floor(seconds))
return string.format("%d:%02d", whole // 60, whole % 60)
end
-- Module phải trả về bảng của nó ở cuối. Thiếu dòng này thì mỗi lần
-- require module này đều lỗi với: Module code did not return exactly one value
return Format
Một script require nó bằng local Format = require(ReplicatedStorage:WaitForChild("Format")), rồi gọi Format.clock(95). Nếu viết Format.Clock(95), bạn sẽ nhận lỗi attempt to call a nil value.
Argument 1 missing or nil
Một hàm Roblox nhận nil ở một đối số mà nó cần, còn con số cho biết là đối số nào. workspace:FindFirstChild(itemName) lỗi kiểu này khi itemName là nil. Bug hiếm khi nằm ở dòng này. Nó nằm ở nơi mà giá trị lẽ ra phải tới: một biến bị gõ sai, một attribute chưa bao giờ được đặt, hoặc một đối số RemoteEvent mà client không gửi. Đối số RemoteEvent tới từ thiết bị của người chơi, nên server phải kiểm tra chúng trước khi dùng. Hướng dẫn RemoteEvent chỉ cách làm việc đó.
FireServer can only be called from the client
RemoteEvent có chiều. LocalScript gọi FireServer, còn Script server lắng nghe bằng OnServerEvent. Script server gọi FireClient hoặc FireAllClients, còn LocalScript lắng nghe bằng OnClientEvent. Gọi method từ sai phía sẽ cho ra lỗi này hoặc lỗi ngược lại, FireClient can only be called from the server. Cách sửa thường là chuyển code sang đúng loại script: xem Script, LocalScript và ModuleScript.
Lỗi DataStore 403 trong Studio
Các lệnh gọi DataStore trong Studio lỗi với mã 403 (StudioAccessToApisNotAllowed) cho tới khi bạn cho phép chúng. Publish place, mở File, Experience Settings, Security, bật Enable Studio Access to API Services và lưu. Sau đó Studio dùng cùng các DataStore với game đang chạy thật, nên Roblox khuyên làm việc này trên một bản sao riêng để test, chứ không phải trên game đang có người chơi. Hãy bọc mọi lệnh gọi DataStore trong pcall, vì các lệnh gọi này có thể lỗi vì những lý do nằm ngoài code của bạn. Cách lưu an toàn được giải thích trong hướng dẫn DataStore.
Script chạy không lỗi nhưng không làm gì cả
Một script im lặng thường là chưa hề chạy, vẫn đang chờ thứ gì đó, hoặc đã chạy sai phía. Trước khi đổi code, hãy cho nó dòng đầu tiên là print(script:GetFullName(), "started") và chạy game. Nếu dòng này không bao giờ hiện trong Output, vấn đề nằm ở chỗ đặt script hoặc cách nó được cài đặt, chứ không phải ở nội dung bên trong.
| Cần kiểm tra gì | Điều gì bị sai | Cách sửa |
|---|---|---|
| Loại và vị trí của script | LocalScript chỉ chạy khi đặt trong StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack hoặc ReplicatedFirst (từ các container Starter nó chạy dưới dạng bản sao của người chơi). Nếu đặt trong Workspace, ServerScriptService hoặc ReplicatedStorage, nó sẽ không bao giờ chạy. Script với RunContext mặc định chỉ chạy trong Workspace hoặc ServerScriptService. | Dời nó đi hoặc dùng loại script khác. Code giao diện và điều khiển dùng LocalScript, luật chơi dùng Script trong ServerScriptService. |
| Enabled | Script bị bỏ tích Enabled sẽ không chạy. | Chọn nó và tích Enabled trong cửa sổ Properties. |
| RunContext | RunContext của Script quyết định nó chạy ở đâu. Legacy, giá trị mặc định, chạy trên server từ Workspace hoặc ServerScriptService. Server chạy trên server, Client chạy trên thiết bị của mỗi người chơi, ví dụ từ ReplicatedStorage. | Đặt nó có chủ đích. Tài liệu Roblox khuyên để Client Script trong ReplicatedStorage hoặc ReplicatedFirst, còn LocalScript trong các container Starter. |
| Sự kiện không kích hoạt | Touched chỉ kích hoạt khi có chuyển động vật lý, cần ít nhất một trong hai part không Anchored, và cần CanTouch ở cả hai. PlayerAdded không kích hoạt cho những người chơi đã có trên server lúc bạn kết nối sự kiện. Hàm xử lý RemoteEvent sẽ không chạy nếu phía bên kia không bao giờ gọi sự kiện. | Đặt một print bên trong hàm xử lý để biết chắc nó có chạy không, rồi sửa thứ lẽ ra phải kích hoạt nó. |
| Code sau vòng lặp hoặc lệnh chờ | Các dòng dưới vòng lặp while true do không bao giờ chạy, vì vòng lặp không kết thúc. Các dòng dưới một WaitForChild không bao giờ tìm thấy object cũng không chạy. | Kết nối sự kiện trước vòng lặp hoặc chạy vòng lặp bằng task.spawn. Cho các lệnh chờ một timeout. |
| Bước kiểm tra lặng lẽ thoát ra | Một lệnh bảo vệ như if not coins then return end lặng lẽ dừng hàm khi object không có. | Thêm một warn kèm chi tiết trước return. |
| Bộ lọc Output | Output có thể lọc theo loại thông báo, theo Client hoặc Server và theo chữ. Một bộ lọc bị quên có thể giấu đúng lỗi bạn đang tìm. | Bỏ các bộ lọc và xóa ô tìm kiếm. |
| Chỉ mình bạn thấy | Thay đổi do LocalScript tạo ra, nên chỉ người chơi đó thấy. Server và những người chơi khác không thấy. | Thực hiện thay đổi trên server. Xem script chạy ở đâu. |
Nhiều người vấp phải trường hợp PlayerAdded, vì khi test trong Studio bạn vào game gần như ngay sau khi server khởi động. Nếu có gì đó phía trên dòng Connect phải chờ, ví dụ WaitForChild, task.wait hoặc require một module có chờ, bạn có thể vào trước khi kết nối được tạo. Hãy xử lý cả người chơi mới lẫn người chơi đã có mặt:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Với những người chơi đã ở đây khi dòng trên chạy,
-- PlayerAdded trong script này sẽ không kích hoạt, nên xử lý họ ngay bây giờ
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Công cụ gỡ lỗi trong Roblox Studio
print và warn có ngữ cảnh
print ghi một dòng vào Output, còn warn ghi một cảnh báo. Đây là cách nhanh nhất để trả lời câu hỏi "cái này có chạy không?" và "giá trị này bằng bao nhiêu?". Một print(x) trơn trọi về sau rất khó tìm, nên hãy thêm nhãn và các chi tiết quan trọng. typeof(x) cho biết đó là loại giá trị gì: số, string, Instance hay nil, còn GetFullName() cho biết chính xác bạn đang có object nào.
local Players = game:GetService("Players")
local DEBUG = true -- đặt false khi bạn xong việc
local TAG = "[ShopServer]"
local function debugPrint(...: any)
if DEBUG then
print(TAG, ...)
end
end
Players.PlayerAdded:Connect(function(player: Player)
debugPrint("joined:", player.Name, player.UserId)
local leaderstats = player:WaitForChild("leaderstats", 10)
if not leaderstats then
warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
return
end
local coins = leaderstats:FindFirstChild("Coins")
-- typeof và ClassName cho biết giá trị thật sự là gì
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Ô tìm kiếm trong Output lọc theo chữ, nên một nhãn cố định như [ShopServer] cho phép chỉ hiện các dòng của hệ thống đó. Nếu cần biết code đã tới dòng này bằng cách nào, debug.traceback() trả về call stack hiện tại dưới dạng string.
Breakpoint và chạy từng bước
Breakpoint tạm dừng game ở một dòng, để bạn có thể xem mọi thứ ngay lúc đó. Trong Script Editor, click vào lề bên phải số dòng (sẽ hiện một chấm đỏ), rồi chạy playtest. Khi chạy tới dòng đó, game tạm dừng, và một mũi tên vàng chỉ dòng tiếp theo. Sau đó các nút chạy từng bước đưa bạn đi tiếp trong code:
- Step Over (F10) chạy dòng hiện tại và dừng ở dòng tiếp theo.
- Step Into (F11) đi vào bên trong hàm được gọi ở dòng này.
- Step Out (Shift+F11) chạy hết hàm hiện tại và dừng ở code đã gọi nó.
- Resume Scripts chạy tiếp tới breakpoint tiếp theo.
Click chuột phải vào lề cho thêm hai loại hữu ích. Breakpoint có điều kiện chỉ tạm dừng khi một biểu thức như amount < 0 đúng. Logpoint in một thông báo ra Output mà không tạm dừng, nên bạn có thể ghi log một giá trị mà không phải sửa script.
Watch và Call Stack
Khi game đang tạm dừng, rê chuột lên một biến trong Script Editor để xem giá trị của nó. Cửa sổ Watch ở tab Variables hiện mọi biến trong phạm vi, còn ở tab My Watches bạn có thể nhập bất kỳ biểu thức nào, ví dụ coins.Value + amount, và xem giá trị hiện tại của nó. Cửa sổ Call Stack cho thấy hàm nào đã gọi hàm nào để tới được dòng đang tạm dừng. Cả hai mở qua tab Script hoặc menu Window.
Script Analysis và strict mode
Script Editor gạch chân vấn đề ngay khi bạn gõ, còn cửa sổ Script Analysis, mở bằng nút Analysis trên tab Script, liệt kê lỗi và cảnh báo trong mọi script. Nó bắt lỗi cú pháp và tên lạ trước khi bạn bấm Play. Nếu đặt --!strict làm dòng đầu tiên của script, chế độ kiểm tra kiểu nghiêm ngặt của Luau sẽ bật, và nó báo thêm cả lỗi gõ sai thuộc tính, sai kiểu đối số và các giá trị có thể là nil. Nhưng nó không nhìn thấy game đang chạy: một part không có trong Workspace thì chỉ Output mới cho bạn biết.
Command bar
Command bar (trên tab Script hoặc Ctrl+9, ⌘9 trên Mac) chạy Luau ngay lập tức. Khi game đang chạy, đây là cách nhanh để hỏi: print(workspace:FindFirstChild("Bridge")) cho biết part đó có tồn tại không, còn print(#game:GetService("Players"):GetPlayers()) đếm số người chơi. Ở chế độ chỉnh sửa, code trong command bar thay đổi place của bạn thật sự, nên hãy cẩn thận với mọi thứ di chuyển hoặc xóa object.
Developer Console trong game thật
Output của Studio chỉ hoạt động trong Studio. Trong game thật, bấm F9 hoặc gõ /console trong chat để mở Developer Console. Phần Log của nó hiện output từ thiết bị của bạn, và cả output của server nếu bạn là chủ game hoặc thành viên của group có quyền chỉnh sửa game.
Assistant có sẵn của Roblox cũng có thể giúp với một thông báo riêng lẻ: hướng dẫn của chính Roblox khuyên dán lỗi từ Output vào và nhờ Assistant giải thích. Nếu Assistant ngừng trả lời hoặc báo bạn đã chạm giới hạn, xem giới hạn và lỗi của Assistant.
Sửa lỗi với RoCode
RoCode là một AI agent độc lập cho Roblox Studio: bạn mô tả vấn đề trong chat trên web, còn plugin Studio đọc và sửa place bạn đang mở. Với lỗi, nó có thể đảm nhận các bước đọc trong trình tự ở trên, dựa vào lần playtest bạn đã chạy.
Mình bấm Play, và click vào nút shop không có tác dụng gì. Output hiện attempt to index nil with 'Coins'. Tìm nguyên nhân và sửa giúp mình.
- Đọc Output trong Studio bằng công cụ Check Output của nó, kể cả các dòng Server và Client từ lần playtest gần nhất của bạn, ngay cả sau khi bạn đã bấm Stop
- Mở script trong lỗi bằng Read Script và đọc code quanh dòng đó, còn bằng Search Scripts nó có thể tìm nơi lẽ ra phải tạo giá trị bị thiếu
- Sửa đúng chỗ bằng Edit Script, tìm và thay chính xác trong script đó, rồi chạy Check Script, công cụ compile script ngay trong Studio (nó không kiểm tra kiểu, không chạy linter và không chạy code của bạn)
- Gửi thay đổi vào Studio theo từng đợt, và mỗi đợt là một điểm undo trong lịch sử Studio
Bấm Play lần nữa và click vào nút shop để tự xác nhận bản sửa: với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, còn với plugin 3.9.15 trở lên nhân vật thử nghiệm của nó có thể bấm các nút trên màn hình, nhưng nó chỉ kiểm tra những gì nó tự chọn để test, và bước kiểm tra compile không cho biết logic game có đúng hay không. Đọc lỗi là một phần của mỗi lần build: chu trình build, kiểm tra và test cho cả một game lặp lại bước kiểm tra này sau mỗi hệ thống. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
Vì sao script trong Roblox không chạy dù không có lỗi?
Thường là script chưa hề chạy (sai loại script hoặc sai container, hoặc Enabled bị tắt), nó vẫn đang chờ thứ gì đó, hoặc sự kiện mà nó lắng nghe không bao giờ kích hoạt. Một print ở dòng đầu tiên sẽ cho biết là trường hợp nào. Xem danh sách kiểm tra ở trên.
"attempt to index nil" trong Roblox nghĩa là gì?
Giá trị trước dấu chấm hoặc dấu hai chấm là nil, nên Roblox không thể nhìn vào bên trong. Trên dòng player.Character.Humanoid, lỗi attempt to index nil with 'Humanoid' nghĩa là player.Character là nil: nó không có hoặc chưa tải xong. Hãy kiểm tra giá trị bằng if trước khi dùng, và trong LocalScript hãy chờ các object do server tạo bằng WaitForChild. Xem thêm về các nguyên nhân.
"infinite yield possible" trong Roblox nghĩa là gì?
WaitForChild đã chờ hơn 5 giây một object con chưa bao giờ xuất hiện, và vẫn đang chờ tiếp. Thường là sai tên hoặc sai parent, hoặc không có gì tạo ra object đó. Xem thêm về các nguyên nhân.
Vì sao cửa sổ Output trống hoặc không hiện?
Mở nó qua menu Window hoặc tab Script. Nếu nó đã mở mà vẫn trống trong lúc test, hãy bỏ các bộ lọc và ô tìm kiếm, rồi kiểm tra rằng các script lẽ ra phải in ra gì đó thật sự có chạy.
Roblox có công cụ kiểm tra lỗi script không?
Có, nó có sẵn trong Studio: Script Editor gạch chân vấn đề khi bạn gõ, còn cửa sổ Script Analysis liệt kê chúng. Chúng tìm ra lỗi cú pháp và lỗi kiểu, nhưng không tìm ra object bị thiếu hay logic game sai: những thứ đó chỉ thấy được khi code đang chạy.
Có nên bọc code trong pcall để không bị lỗi không?
Chỉ những lệnh gọi có thể lỗi vì lý do nằm ngoài code của bạn, ví dụ yêu cầu tới DataStore, HTTP hoặc MarketplaceService. Nếu bọc một lỗi nil trong pcall, thông báo sẽ biến mất nhưng tính năng vẫn không chạy.
Làm sao xem lỗi script trong game thật?
Bấm F9 trong game hoặc gõ /console trong chat để mở Developer Console. Nó hiện lỗi từ thiết bị của bạn, và cả từ server nếu bạn là chủ game hoặc thành viên group có quyền chỉnh sửa game.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Output (bằng tiếng Anh). Output nằm ở đâu, các bộ lọc và cài đặt hiển thị của nó
- Roblox Creator Docs: Debugging (bằng tiếng Anh). breakpoint, chạy từng bước, Watch, Call Stack, command bar và Developer Console
- Roblox Creator Docs: Script Editor (bằng tiếng Anh). cửa sổ Script Analysis
- Roblox Creator Docs: Studio interface (bằng tiếng Anh). nơi mở Output và command bar
- Roblox Creator Docs: Script types and locations (bằng tiếng Anh). mỗi loại script chạy ở đâu và RunContext
- Roblox Creator Docs: Studio testing modes (bằng tiếng Anh). Play, chế độ xem Client và Server, và test Server & Clients
- Roblox Engine API: Instance (bằng tiếng Anh). WaitForChild, timeout của nó và cảnh báo sau 5 giây
- Roblox Creator Docs: Reuse code (bằng tiếng Anh). ModuleScript và require đệ quy
- Roblox Creator Docs: Data store error codes and limits (bằng tiếng Anh). lỗi 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (bằng tiếng Anh). bật quyền truy cập từ Studio và bản sao riêng để test
- Roblox Engine API: BasePart (bằng tiếng Anh). khi nào Touched kích hoạt, và CanTouch
- Roblox Creator Docs: Type checking (bằng tiếng Anh). strict mode
- Roblox Creator Docs: Developer Console (bằng tiếng Anh). ai thấy output của server trong game thật
- Roblox Creator Docs: Build your first game with Assistant (bằng tiếng Anh). dán lỗi từ Output để Assistant giải thích
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.