Xây dựng kiến trúc Multi-Tenancy dùng chung Database trong Laravel: Nền tảng của sự an toàn

Bài viết được dịch và tổng hợp từ tin tức gốc. Bạn có thể đọc bài viết gốc bằng tiếng Anh tại đây.

Điểm tin nhanh:

• Triển khai Multi-Tenancy dùng chung database đòi hỏi sự cô lập dữ liệu nghiêm ngặt ở tầng ứng dụng.
• Sử dụng TenantContext singleton kết hợp với Global Scopes và Trait là chìa khóa để tự động hóa việc lọc dữ liệu theo tenant_id.
• Kiểm thử tự động (CI) là lớp bảo vệ cuối cùng để đảm bảo mọi model đều được áp dụng cơ chế scoping, tránh sai sót con người.

Trong thế giới SaaS, việc để dữ liệu của khách hàng này rò rỉ sang khách hàng khác không chỉ là một lỗi kỹ thuật đơn thuần, mà là một thảm họa về uy tín. Khi bạn chọn chiến lược Shared-Database Multi-Tenancy, bạn đang chấp nhận một thỏa thuận ngầm: sự đơn giản trong vận hành đổi lấy trách nhiệm nặng nề trong việc bảo mật. Nếu bạn từng lo lắng về việc quên thêm where('tenant_id', ...) trong một câu query phức tạp, thì bài viết này chính là giải pháp giúp bạn ngủ ngon hơn.

Tại sao chọn Shared-Database Multi-Tenancy?

Việc lựa chọn kiến trúc database là quyết định sống còn của một hệ thống. Dưới đây là bảng so sánh nhanh các chiến lược phổ biến:

Với các ứng dụng greenfield, Shared-Database là lựa chọn tối ưu về chi phí. Tuy nhiên, như đã phân tích trong các bài viết về những quy luật ngầm định hình chất lượng phần mềm, sự kỷ luật của lập trình viên là không đủ. Chúng ta cần các công cụ kỹ thuật để biến việc bảo mật thành mặc định.

Xây dựng TenantContext: Trái tim của hệ thống

Thay vì đọc tenant từ session hay request trực tiếp, hãy sử dụng một Singleton để lưu trữ ngữ cảnh. Điều này giúp code của bạn linh hoạt hơn, dễ dàng thay đổi cách xác định tenant (từ domain, sub-domain hoặc config) mà không ảnh hưởng đến các tầng bên dưới.

class TenantContext
{
    private ?Tenant $tenant = null;
    private bool $scopeDisabled = false;

    public function id(): ?int { return $this->tenant?->getKey(); }
    public function has(): bool { return $this->tenant instanceof Tenant; }

    public function shouldScope(): bool
    {
        return ! <code class="math-inline">this->scopeDisabled &&</code>this->has();
    }
}

Việc kiểm soát shouldScope() rất quan trọng, đặc biệt trong các tác vụ chạy ngầm hoặc console command, nơi mà tenant chưa được xác định. Nếu bạn đang quan tâm đến việc tối ưu hóa các quy trình tự động, hãy tham khảo thêm về tối ưu hóa quy trình triển khai.

Tự động hóa với Trait BelongsToTenant

Để tránh việc phải thủ công thêm điều kiện lọc, chúng ta sử dụng một Trait để tự động hóa việc này thông qua Global Scope của Eloquent.

trait BelongsToTenant
{
    public static function bootBelongsToTenant(): void
    {
        $context = app(TenantContext::class);

        static::addGlobalScope('tenant', function (Builder <code class="math-inline">q) use (</code>context) {
            if (! $context->shouldScope()) return;
            <code class="math-inline">q->where(</code>q->getModel()->getTable().'.tenant_id', $context->id());
        });

        static::creating(function (<code class="math-inline">model) use (</code>context) {
            if (<code class="math-inline">model->tenant_id === null &&</code>context->has()) {
                <code class="math-inline">model->tenant_id =</code>context->id();
            }
        });
    }
}

Mẹo hay: Việc sử dụng $q->getModel()->getTable().'.tenant_id' giúp tránh lỗi ambiguous column khi bạn thực hiện các câu lệnh join giữa các bảng cùng thuộc tính tenant.

Lớp bảo vệ cuối cùng: Kiểm thử tự động

Đừng tin vào trí nhớ của chính mình. Hãy tạo một test case để quét toàn bộ các model trong hệ thống. Nếu một bảng có cột tenant_id mà thiếu trait BelongsToTenant, CI sẽ ngay lập tức báo lỗi.

it('scopes every model whose table carries tenant_id', function () {
    $missing = [];
    foreach (tenancyModelClasses() as $class) {
        <code class="math-inline">table = (new</code>class)->getTable();
        if (Schema::hasColumn(<code class="math-inline">table, 'tenant_id') && ! usesBelongsToTenant(</code>class)) {
            <code class="math-inline">missing[] =</code>class;
        }
    }
    expect($missing)->toBe([]);
});

Đây là cách tiếp cận tương tự như cách chúng ta xây dựng các hệ thống bảo mật trong kỷ nguyên tự động hóa, như đã thảo luận trong bài viết về xây dựng phần mềm bảo mật.

Đánh giá & Lời khuyên Thực tiễn

• Ưu điểm: Tiết kiệm chi phí hạ tầng, dễ dàng quản lý migration cho toàn bộ hệ thống.
• Nhược điểm: Rủi ro cao nếu lập trình viên quên áp dụng trait. Cần quản lý chặt chẽ các chỉ mục (index) trên cột tenant_id để tránh suy giảm hiệu năng khi dữ liệu lớn.
• Lưu ý: Đối với các dữ liệu dùng chung (như bảng countries hoặc settings), hãy đảm bảo không áp dụng trait này. Luôn kiểm tra kỹ các ràng buộc unique – một số trường cần unique trên toàn hệ thống, một số chỉ cần unique trong phạm vi tenant.
• Phạm vi ứng dụng: Phù hợp cho các ứng dụng SaaS vừa và nhỏ, nơi mà việc duy trì hàng trăm database riêng biệt là gánh nặng vận hành.

Câu hỏi thường gặp (FAQ)

Làm sao để truy cập dữ liệu xuyên tenant khi cần thiết?

Bạn có thể thêm phương thức withoutScope vào TenantContext để tạm thời vô hiệu hóa Global Scope trong một closure, giúp thực hiện các tác vụ quản trị hệ thống.

Có nên dùng package có sẵn thay vì tự viết không?

Nếu dự án của bạn phức tạp, các package như stancl/tenancy là lựa chọn tốt. Tuy nhiên, việc tự xây dựng nền tảng giúp bạn hiểu sâu về cách Laravel xử lý query và kiểm soát hoàn toàn bảo mật.

Làm thế nào để xử lý các bảng không thuộc về bất kỳ tenant nào?

Chỉ cần không thêm cột tenant_id vào các bảng đó và không sử dụng trait BelongsToTenant. Global Scope sẽ không được kích hoạt.

Kết luận

Shared-Database Multi-Tenancy không phải là một thử thách về sự cẩn thận, mà là một thử thách về thiết kế hệ thống. Bằng cách sử dụng TenantContext và kiểm thử tự động, bạn có thể biến các rủi ro bảo mật thành những lỗi kỹ thuật được phát hiện ngay từ khâu CI. Hãy bắt đầu xây dựng nền tảng vững chắc cho ứng dụng của bạn ngay hôm nay. Nếu bạn thấy bài viết hữu ích, đừng quên theo dõi hi_dev để cập nhật thêm nhiều kiến thức chuyên sâu về kỹ thuật phần mềm.