How to fix the MySQL related 'Specified key was too long error' error in Laravel

October 26, 2018

This is a common problem (especially if you use a local development environment such as XAMPP).

The error will look something like this:

[Illuminate\Database\QueryException] SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

[PDOException] SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

Luckily the fix is simple. Add the following to the boot() method of your app/Providers/AppServiceProvider.php file:

<?php
Schema::defaultStringLength(191);