初學laravel migrate常見錯誤解決
斷斷續續開始 laravel 入門學習,想整個簡單的通訊錄系統,設立了兩個表,一個 branches ,一個 contacts。在創建 migration 文件的時候,沒有考慮仔細,先把 contacts 表建立了,contacts 表有個外鍵連接到 branches 的 id,結果執行 migrate 命令的時候,出現以下錯誤:
- [Illuminate\Database\QueryException]
- SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint (SQL: alter table `contacts` add constraint `contac
- ts_branch_id_foreign` foreign key (`branch_id`) references `branches` (`id`) on delete cascade)
- [PDOException]
- SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint
初步懷疑是表創建先后不規范造成,于是,手動修改 branches 的 migration 文件名稱上的日期,再執行
- php artisan migrate:reset
出現如下錯誤:
- [ErrorException]
- include(/Users/Ade/www/laravel_phonebook5.2): failed to open stream: Operation now in progress
failed to open stream 錯誤解決
光看錯誤提示不是很理解,我們查看 laravel 的 log 文件
- more storage/logs/laravel.log
找到出現 ERROR 的那段話:
- [2016-09-29 18:05:35] local.ERROR: exception 'ErrorException' with message 'include(/Users/Ade/www/laravel_phonebook5.2): failed to open stream: Operation now in progress' in /Users/Ade/www/laravel_phonebook5.2/vendor/composer/ClassLoader.php:412
- Stack trace:
- #0 /Users/Ade/www/laravel_phonebook5.2/vendor/composer/ClassLoader.php(412): Illuminate\Foundation\Bootstrap\HandleExceptions->handleError(2, 'include(/Users/...', '/Users/Ade/www/...', 412, Array)
- #1 /Users/Ade/www/laravel_phonebook5.2/vendor/composer/ClassLoader.php(412): Composer\Autoload\includeFile()
- #2 /Users/Ade/www/laravel_phonebook5.2/vendor/composer/ClassLoader.php(301): Composer\Autoload\includeFile('/Users/Ade/www/...')
- #3 [internal function]: Composer\Autoload\ClassLoader->loadClass('CreateBranchesT...')
- #4 /Users/Ade/www/laravel_phonebook5.2/vendor/laravel/framework/src/Illuminate/Database/Migrations/Migrator.php(335): spl_autoload_call('CreateBranchesT...')
- #5 /Users/Ade/www/laravel_phonebook5.2/vendor/laravel/framework/src/Illuminate/Database/Migrations/Migrator.php(227): Illuminate\Database\Migrations\Migrator->resolve('2016_09_12_1728...')
- #6 /Users/Ade/www/laravel_phonebook5.2/vendor/laravel/framework/src/Illuminate/Database/Migrations/Migrator.php(206): Illuminate\Database\Migrations\Migrator->runDown(Object(stdClass), false)
錯誤出現在 ClassLoader.php 文件的 412 行
查看改行代碼,發現是一個調用文件的語句:
而這個文件,在 log 文件中已經指出,即 resolve('2016_09_12_1728...') 。log 提示的這個名稱,就是我修改的 branch 的 migration 文件名稱。
我們再搜搜正常的 migration 文件會在哪些地方出現:
- mdfind 2014_10_12_000000_create_users_table.php|grep phonebook
可見,正常的有 3 個地方出現,修改過的只有 1 個地方出現。
編輯這兩個未出現的文件
調整 autoload_static.php 文件
發現 vendor/composer/autoload_static.php 文件中,和 branches 相關的語句如下:
- 'CreateBranchesTable' => __DIR__ .,
想來應該是改名的時候,PHP Storm自動幫我把這個文件里面有關 branches 文件路徑全部給刪掉了。加回去就好了。
參照正常的 migration 文件名的配置情況,補充為
- 'CreateBranchesTable' => __DIR__ . '/../..' . '/database/migrations/2016_09_12_172822_create_branches_table.php',
調整 autoload_classmap.php 文件
我們發現 autoload_classmap.php 文件中,有關 branches 的路徑名還是修改前的路徑:
- 'CreateBranchesTable' => $baseDir . '/database/migrations/2016_09_29_172822_create_branches_table.php',
將其修改為
- 'CreateBranchesTable' => $baseDir . '/database/migrations/2016_09_12_172822_create_branches_table.php',
再執行 migrate 命令
- php artisan migrate:reset
OK,剛才的錯誤沒了,不過我們又發現 contacts 表沒有回滾,
contacts 回滾失敗的分析
通過 sequel pro 連上數據庫查看
發現 contacts 表果然存在,但是 migration 表中已沒有內容,想必再執行前面 migrate 命令的時候出現錯誤,contacts 的執行記錄并沒有寫入 migrations 表中。我們可以重新執行 migrate 命令試試看。首先手動刪除這兩張表,也就是清空數據庫,然后執行:
- php artisan migrate
我們先忽視創建 contacts 表出現的錯誤,刷新 sequel pro 查看一下:
果然,migration 表中沒有 contacts 的創建記錄,這也就難怪執行 reset 的時候,會沒有 contacts 的回滾操作了。
contacts 無法創建 branch_id 外鍵的解決
現在,我們已經執行了 migrate 命令,我們重新來看看這個最早出現的錯誤:
- [Illuminate\Database\QueryException]
- SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint (SQL: alter table `contacts` add constraint `contacts_branch_id_foreign` foreign key (`branch_id`) references `br
- anches` (`id`) on update cascade)
- [PDOException]
- SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint
冷靜下來分析一下,既然提示的是 SQL 錯誤,我們不妨在 sequel pro 中手工執行一下這條 SQL 語句。
果然,執行返回錯誤。
仔細查看語句并沒有錯誤,一想,應該是 branch_id 類型聲明和 branches 表中的 ID 類型不一致造成的吧。查看 contacts 的結構,發現 Unsigned 沒有打鉤,勾選后再執行增加外鍵的 SQL 語句,成功。
找到問題原因后,我們就清空數據庫,修改 contacts 的 migration 文件,調整 branch_id 為:
- $table->integer('branch_id')->unsigned()->comment('機構ID');
再重新執行 migrate 命令,成功!