fix(core): installer_completed fast-path가 빈 DB 배포 시 부팅을 깨뜨리는 문제 수정 및 7.0.3 릴리스
INSTALLER_COMPLETED=true 가 적힌 .env 를 빈 DB 새 서버에 복사한 뒤
php artisan migrate 로 테이블을 만들기 전에 앱이 부팅되면, installer_completed
fast-path 가 테이블 존재를 잘못 전제하여 뒤따르는 쿼리가 table not found 로
부팅을 깨뜨렸다. 마이그레이션을 실행하려는 부팅에서 그 명령이 오히려 실패하는
닭-달걀 상태가 된다.
fast-path 자체(매 요청 information_schema 쿼리 제거 성능 최적화)는 유지하되,
이미 존재하던 참조 구현(LanguagePackServiceProvider::isRegistryReady)의 방어
패턴을 InstallerContext::isSchemaMutatingCommand 로 SSoT 화하여 나머지 5곳에
통일 적용했다.
- app/Support/InstallerContext.php: 마이그레이션 계열 콘솔 명령 판정 헬퍼
(migrate/migrate:fresh/migrate:refresh/migrate:rollback/migrate:reset/db:wipe)
- Caches{Module,Plugin,Template}Status: fast-path 앞에 && 가드
- {Module,Plugin}RouteServiceProvider: hasTable 검증 진입 조건에 || 가드로
무방비 pluck 도달 차단
- LanguagePackServiceProvider: 인라인 argv 검사를 헬퍼로 치환(migrate:refresh 보강)
부류 B(NotificationHookListener, IdentityPolicyRepository)는 fast-path 이후
쿼리가 이미 try/catch 로 보호되어 빈 DB 에서도 안전하므로 수정 제외.
최초 설치 흐름은 migrate 시점에 완료 플래그가 없어(false) 이번 가드의 영향권
밖이며 원래대로 hasTable 폴백을 탄다. 가드가 실제 발동하는 유일 케이스는
"플래그 true + 빈 DB" 뿐이고, 정상 운영 웹 요청은 fast-path 성능이 유지된다.
회귀 테스트: InstallerContextTest 8건 + InstallerCompletedGuardTest 5건 추가
(수정 전 5건 fail → 수정 후 green). 관련 스위트 355 passed.
7.0.3 출시 버전 bump: 코어 버전 SSoT 7곳 + CHANGELOG 동기화.
This commit is contained in:
1 parent
13aeb433cc
commit
c26b49a997
16 files changed
+386
-23
No files matched your search
@@ -7,8 +7,11 @@ use App\Extension\ModuleManager;
|
||||
use App\Extension\PluginManager;
|
||||
use App\Extension\TemplateManager;
|
||||
use App\Listeners\NotificationHookListener;
|
||||
use App\Providers\ModuleRouteServiceProvider;
|
||||
use App\Providers\PluginRouteServiceProvider;
|
||||
use Illuminate\Foundation\Testing\RefreshDatabase;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use ReflectionClass;
|
||||
use Tests\TestCase;
|
||||
|
||||
/**
|
||||
@@ -22,12 +25,43 @@ class InstallerCompletedGuardTest extends TestCase
|
||||
{
|
||||
use RefreshDatabase;
|
||||
|
||||
/** @var array<int, string>|null 원본 argv 백업 */
|
||||
private ?array $originalArgv = null;
|
||||
|
||||
protected function tearDown(): void
|
||||
{
|
||||
config(['app.installer_completed' => false]);
|
||||
|
||||
if ($this->originalArgv !== null) {
|
||||
$_SERVER['argv'] = $this->originalArgv;
|
||||
$this->originalArgv = null;
|
||||
}
|
||||
|
||||
parent::tearDown();
|
||||
}
|
||||
|
||||
/**
|
||||
* $_SERVER['argv'] 를 마이그레이션 명령으로 임시 설정하고 콜백을 실행합니다.
|
||||
*
|
||||
* PHPUnit 은 이미 콘솔 컨텍스트이므로, argv[1] 만 'migrate' 로 바꾸면
|
||||
* InstallerContext::isSchemaMutatingCommand() 가 true 가 되어 fast-path 가 무력화된다.
|
||||
* argv 는 finally 에서 반드시 원복해 다른 테스트 오염을 막는다.
|
||||
*
|
||||
* @param callable $callback 마이그레이션 컨텍스트에서 실행할 코드
|
||||
*/
|
||||
private function withMigrationArgv(callable $callback): void
|
||||
{
|
||||
$this->originalArgv = $_SERVER['argv'] ?? [];
|
||||
$_SERVER['argv'] = ['artisan', 'migrate'];
|
||||
|
||||
try {
|
||||
$callback();
|
||||
} finally {
|
||||
$_SERVER['argv'] = $this->originalArgv;
|
||||
$this->originalArgv = null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 주어진 콜백 실행 중 발생한 information_schema.tables 쿼리만 수집합니다.
|
||||
*
|
||||
@@ -187,4 +221,90 @@ class InstallerCompletedGuardTest extends TestCase
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), 'installer_completed=false 에서는 기존 hasTable 경로가 실행되어야 합니다');
|
||||
}
|
||||
|
||||
/*
|
||||
|--------------------------------------------------------------------------
|
||||
| 마이그레이션 컨텍스트 가드 (빈 DB 배포 안전성)
|
||||
|--------------------------------------------------------------------------
|
||||
|
|
||||
| INSTALLER_COMPLETED=true .env 를 빈 DB 새 서버에 복사한 뒤 `php artisan migrate`
|
||||
| 부팅 시, fast-path 가 테이블 존재를 잘못 전제해 뒤따르는 쿼리가 table not found 로
|
||||
| 부팅을 깨뜨리던 결함을 막는다. 마이그레이션 계열 명령 컨텍스트에서는
|
||||
| installer_completed=true 라도 fast-path 를 우회해 hasTable 실검증 경로로 진입해야 한다.
|
||||
| (RefreshDatabase 는 테이블을 만들므로 실제 not-found 는 재현 불가 → 가드 발동으로
|
||||
| hasTable 쿼리가 다시 발생하는지를 쿼리카운트로 검증)
|
||||
*/
|
||||
|
||||
public function test_module_trait_uses_has_table_during_migration_despite_installer_completed(): void
|
||||
{
|
||||
config(['app.installer_completed' => true]);
|
||||
|
||||
$this->withMigrationArgv(function () {
|
||||
$schemaQueries = $this->captureSchemaTableQueries(
|
||||
fn () => ModuleManager::getActiveModuleIdentifiers()
|
||||
);
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), '마이그레이션 중에는 installer_completed=true 라도 hasTable 폴백 경로로 진입해야 합니다');
|
||||
});
|
||||
}
|
||||
|
||||
public function test_plugin_trait_uses_has_table_during_migration_despite_installer_completed(): void
|
||||
{
|
||||
config(['app.installer_completed' => true]);
|
||||
|
||||
$this->withMigrationArgv(function () {
|
||||
$schemaQueries = $this->captureSchemaTableQueries(
|
||||
fn () => PluginManager::getActivePluginIdentifiers()
|
||||
);
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), '마이그레이션 중에는 installer_completed=true 라도 hasTable 폴백 경로로 진입해야 합니다');
|
||||
});
|
||||
}
|
||||
|
||||
public function test_template_trait_uses_has_table_during_migration_despite_installer_completed(): void
|
||||
{
|
||||
config(['app.installer_completed' => true]);
|
||||
|
||||
$this->withMigrationArgv(function () {
|
||||
$schemaQueries = $this->captureSchemaTableQueries(
|
||||
fn () => TemplateManager::getActiveTemplateIdentifiers()
|
||||
);
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), '마이그레이션 중에는 installer_completed=true 라도 hasTable 폴백 경로로 진입해야 합니다');
|
||||
});
|
||||
}
|
||||
|
||||
public function test_module_route_provider_uses_has_table_during_migration_despite_installer_completed(): void
|
||||
{
|
||||
config(['app.installer_completed' => true]);
|
||||
|
||||
$provider = new ModuleRouteServiceProvider($this->app);
|
||||
$method = (new ReflectionClass($provider))->getMethod('loadModuleRoutes');
|
||||
$method->setAccessible(true);
|
||||
|
||||
$this->withMigrationArgv(function () use ($provider, $method) {
|
||||
$schemaQueries = $this->captureSchemaTableQueries(
|
||||
fn () => $method->invoke($provider)
|
||||
);
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), '마이그레이션 중에는 installer_completed=true 라도 modules hasTable 검증 경로로 진입해 무방비 pluck 을 막아야 합니다');
|
||||
});
|
||||
}
|
||||
|
||||
public function test_plugin_route_provider_uses_has_table_during_migration_despite_installer_completed(): void
|
||||
{
|
||||
config(['app.installer_completed' => true]);
|
||||
|
||||
$provider = new PluginRouteServiceProvider($this->app);
|
||||
$method = (new ReflectionClass($provider))->getMethod('loadPluginRoutes');
|
||||
$method->setAccessible(true);
|
||||
|
||||
$this->withMigrationArgv(function () use ($provider, $method) {
|
||||
$schemaQueries = $this->captureSchemaTableQueries(
|
||||
fn () => $method->invoke($provider)
|
||||
);
|
||||
|
||||
$this->assertGreaterThan(0, count($schemaQueries), '마이그레이션 중에는 installer_completed=true 라도 plugins hasTable 검증 경로로 진입해야 합니다');
|
||||
});
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user