Godot Invalid Access to Property on Null Instance Error

How to fix it

Try these in order — the most common fix is first.

1. 1. Check the node path

   Copy steps
   1. Right-click the node in the Scene dock and choose Copy Node Path
   2. Compare it with the path in get_node() or $
   Did this fix it? Yes No

2. 2. Use @onready or unique names

   Copy steps
   1. Declare references with @onready var x = $Child
   2. Or right-click the node, choose Access as Scene Unique Name, and use %Name inside the same scene
   Did this fix it? Yes No

3. 3. Assign exported nodes

   1. Select the node with the script and set the @export field in the Inspector
   Did this fix it? Yes No

4. 4. Guard references that may be gone

   Copy steps
   1. Use if is_instance_valid(target) before access
   2. Find which variable is null by reading the 'base object' part of the message and tracing its assignment
   Did this fix it? Yes No

Symptoms

Game stops with 'Invalid access to property or key', 'Invalid call. Nonexistent function ... in base Nil' or 'Node not found' in the debugger.

Why it happens

• Wrong node path or a typo in $Node
• Variable read before the node is in the scene tree (missing @onready)
• @export node never assigned in the Inspector
• Node was freed or never instanced

This guide also covers

• godot invalid access to property or key null instance
• godot nonexistent function in base nil
• godot node not found
• godot onready null

The same problem in other apps

All not loading, error messages & connection guides →

• Unity Package Manager Errors (Unity)
• Unreal Engine Out of Video Memory Error (Unreal Engine)

Other Godot errors

• Godot No Export Template Found at the Expected Path
• Godot Android Export Failed (JDK, SDK and Keystore Errors)
• Godot 4 Crashes on Startup: Vulkan Device Errors
• Godot C# Error: Godot.NET.Sdk or .NET SDK Not Found
• Godot 3 to 4 Upgrade: Project Errors After Converting
• Godot Shader Compilation Stutter and Lag on First Run
• Godot Web Export Not Working: SharedArrayBuffer and Blank Page
• Godot Exported Game Blocked on macOS: Developer Cannot Be Verified