When MVC 5, SignalR And NuGet Just Won't Get Along

Sometimes things just blow up:

If you have recently attempted to create a new ASP.NET MVC 5 project (or any new Web Project within Visual Studio 2013) and decided that you wanted some of that sweet SignalR magic in your application, then you may have encountered the following error:

An exception of type ‘System.IO.FileLoadException’ occurred in Microsoft.AspNet.SignalR.Core.dll but was not handled in user code.

Additional information: Could not load file or assembly ‘Microsoft.Owin, Version=2.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35′ or one of its dependencies. The located assembly’s manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)

This can easily be reproduced through the following steps:

1. Create a new Web Application Project in Visual Studio 2013 that uses built-in Forms Authentication (Individual User Accounts).
   
   
2. Add the SignalR package through NuGet.
   
   
3. Attempt to add the following code to your Startup.cs file:
   
   1. public partial class Startup
   2. {
   3. public void Configuration(IAppBuilder app)
   4. {
   5. // Add SignalR Mappings
   6. app.MapSignalR();
   7. ConfigureAuth(app);
   8. }
   9. }
   If you did everything right, then grab some popcorn because you are about to see this:
   
   

Why is this happening to me?

Of all of the things to blame, we are going to choose NuGet for this one.

This is currently a known issue within NuGet. The reason for this is that SignalR and some other binaries are built with a dependency over Microsoft.Owin Version 2.0.0, however the appropriate assembly binding redirects are not occurring. This causes a problem as the latest available version of Microsoft.Owin in the public NuGet feed is greater than 2.0.0.

Okay. But how do I fix it?

There are two options here, which I have each had success with so I’ll start with the easiest approach, installing a specific updated version of Microsoft.Owin and Microsoft.Owin.Security and ensuring that you are properly targeting it within your web.config.

You can do this within the following steps:

• Access the NuGet command-line tool within Visual Studio, accessible under Tools > Library Package Manager > Package Manager Console.
  
  
• Install an updated version of Microsoft.Owin and Microsoft.Owin.Security (2.0.1, 2.1.0, 2.2.0 or any other version) using the following command:
  
  Install-Package Microsoft.Owin -Version 2.1.0
  Install-Package Microsoft.Owin.Security -Version 2.1.0
  
  
• Ensure that your web.config has the appropriate attributes to target the version you selected as seen below: