What is a Null Reference Exception In Unity.

This question comes up very frequently so I decided I would create a general explanation of what a Null Reference Exception is. This isn't so much for me as it is for beginners and others new to programming or Unity.

Because the biggest problem appears to be that people new to programming or .Net don't understand what a NullReferenceException means, and it really isn't too hard to fix if you know what your looking for.

So, I'll be posting my explanation. If anyone else has a good explanation, then please post so that there can be one catch-all question for NullReferenceExceptions.

more ▼

asked Feb 15, 2011 at 08:57 PM

avatar image

Peter G
18.4k 34 87 218

(comments are locked)
10|3000 characters needed characters left

3 answers: sort voted first

NullReferenceException are thrown when you try to access a reference variable that isnt referencing any object, hence it is null. So the first question, are all variables reference types?

No, in Mono, there are two kinds of variables that are used for most variables: value types and reference types. Value types store a value directly such as an int or a double or any struct such as a Vector3, or an enumeration.

Reference types, on the other hand to not directly store the object data, instead, they store a reference to an object similar to pointers in C/C++. Common reference types are classes, delegates, and strings. Reference types default to null, that is that they are not referencing any object. Hence, if you try and access the object that is being referenced and their isnt one, you will get a NullReferenceException.

Here is another Answer about null references that explains the same thing in slightly different words.

Some common examples:

 var t : Transform; 
 //t is a reference to a Transform.
 //If you do not assign a Transform to it in the Inspector, then
 //it will be be a null reference..
 function Start () {
      //If t does not have a Transform, then you will get a NullReferenceException

If you try to get a component that isnt there then try to access it:

 function Start () {
       var c : Light = GetComponent(Light);
      c.range = 10;
      //If this object doesnt have a light on it, then you will get
      //a NullReferenceException

Accessing a GameObject that doesnt exist:

 function Start () {
     var someGameObject : GameObject = GameObject.Find("AGameObjectThatDoesntExist");
     someGameObject.name = "NullReferenceException";

Less common, but annoying if you don't know it:

 //Note this example is C#. There is no good way of doing delegates in js
 public void NullDelegate (MyEmptyDelegate del) {
      //if you call a delegate that doesn't have any methods attached, you will get a NullReference Exception.


Now to how to fix them: obviously the easiest way to fix them is to not have any NullReferences. But many times thats not possible so you need to have either try-catch blocks or conditionals.

For example:

 var c = GetComponent(MyComponent);
 if(c != null) {
     //Make sure we have a reference.
     //Do the rest of the stuff.
 else {
     Debug.Log(There is no MyComponent attached to this object);


 try {
      //execute code;
 catch (var ex : NullReferenceException) {
       //Do other stuff.

try/catch blocks require that you throw an exception and that does cost resources so more often than not, even though it is sometimes cleaner to read, it isn't as performance efficient.

more ▼

answered Feb 15, 2011 at 08:59 PM

avatar image

Peter G
18.4k 34 87 218

Awesome explanation! Thank you it help me to undarstand core of my probleme

Oct 23, 2013 at 01:28 AM ScorpyX

Ty for the nice work :-)

Jan 14, 2014 at 03:53 AM Pedro Oliveira
(comments are locked)
10|3000 characters needed characters left

In simple terms:

A null reference error means something before a dot is null.

To Fix

  • Find the line from the error code

  • Find the dot

  • Figure out what is null. Debug.Log is your friend

  • Make it not null, or add null checking before hand

(Note: this answer is not technically correct, but it is a pretty good working solution for 99% of beginner null reference exceptions. If you can write a delegate, you can read the documentation and identify your own null references)

more ▼

answered Jan 04 at 11:27 PM

avatar image

21k 2 14 116

(comments are locked)
10|3000 characters needed characters left
Your answer
toggle preview:

Up to 2 attachments (including images) can be used with a maximum of 524.3 kB each and 1.0 MB total.

Follow this question

By Email:

Once you sign in you will be able to subscribe for any updates here



Answers and Comments



asked: Feb 15, 2011 at 08:57 PM

Seen: 39848 times

Last Updated: Jan 04 at 11:31 PM