ارور Specified key was too long در جنگو

python manage.py makemigrations
python manage.py migrate

Specified key was too long; max key length is 1000 bytesدر اروری که در ترمینال نمایش داده می‌شود، دقیقا مایگریشنی که ارور دارد مشخص می‌شود و شماره مایگریشن، نام دقیق مایگریشنی و اینکه مربوط به کدام اپ پروژه است، در متن خطا به آن اشاره می‌شود. 

 

مایگریشن‌ها و تنظیمات مرتبط

• هر اپ موجود در پروژه، دارای یک فولدر migrations می‌باشد که تغییراتی که باید در دیتابیس اعمال شود، در آن ذخیره می‌شود.

• اگر با خطای مایگریشن مواجه شدید، باید مدل مربوط به همان اپ اصلاح شود.

 

نکات مهم در تنظیمات کاراکترهای فارسی و ایندکس‌ها

1. استفاده از کاراکترهای فارسی در اسلاگ و URL:

   • در صورتی که از کاراکتر های فارسی در اسلاگ و URL استفاده شود، باید مقدار max_length آن رکورد حداکثر 250 تنظیم شود.

2. محدودیت‌های MySQL 8.0.3:

   • در MySQL 8.0.3 وقتی یک ستون به عنوان ایندکس انتخاب می‌شود (یعنی مقدار db_index=True به عنوان ویژگی آن تعریف می‌شود)، حداکثر تعداد کاراکتر یا max_length آن ستون باید 250 کاراکتر باشد.
   • اگر عدد بیشتری از این مقدار تنظیم شود، پروژه با خطای زیر مواجه می‌شود:
     • Error: The column size is too large for the index.

3. **محدودیت‌های SlugField:

   • در مورد SlugField نیز، حداکثر مقدار مجاز کاراکتر 250 کاراکتر می‌باشد.

 

حذف مایگریشن های قبلی و ایجاد مایگریشن های جدید

بعد از اینکه تغییرات مورد نظر بر روی مدل‌ها اعمال شد و مواردی که max-lenght آنها به 250 تغییر پیدا کرد، باید مایگریشن‌های قبلی حذف شود تا مایگریشن های جدید ایجاد شود.

در ترمینال و در مسیر پروژه با زدن جداگانه هر کدام از دستورات زیر، مایگریشن‌ها و کش مربوط به مایگریشن‌ها (محتویات فولدر _pycache_) حذف می‌شوند .

find . -path "*/migrations/*.py" -not -name "__init__.py" -delete
find . -path "*_pycache_*.pyc" -delete

 

در هر فولدر migrations یک فایل به نام __init__.py باید وجود داشته باشد.

اگر احیانا به اشتباه این فایل پاک شد، باید فایلی به همین نام و بدون هیچ محتوایی، ایجاد شود. این فایل بدون هیچ محتوایی می‌باشد و برای تهیه مایگریشن در فولدر migrations ضروری است.

توجه داشته باشید که بعد از تغییرات و ایجاد مایگریشن جدید و قبل از اجرای دستور python manage.py migrate باید جداول دیتابیس مربوط به پروژه حذف شوند، یعنی همه آنها انتخاب و drop شوند تا از نو ساخته شوند.

در صورتی که این کار انجام نشود، در زمان مایگریت، پیامی نمایش داده می‌شود که یک جدول در دیتابیس با نام مشابه وجود دارد و عملیات migrate ناقص می‌ماند.

در صورتی که خطای دیگری وجود نداشته باشد، عملیات migrate انجام می‌شود و تغییرات در دیتابیس اعمال می‌شود.

بعد از مایگریت موفق، پروژه راه‌اندازی می‌شود و می‌توانیم با تایپ آدرس نام دامنه و یا سابدامنه در مرورگر، وب‌ سایت خود را مشاهده کنیم.

در صورتی که با تغییرات بالا، خطای پروژه شما رفع نشد و پروژه راه‌اندازی نشد، می‌توانید به پشتیبانی پارس وب سرور تیکت بزنید تا همکاران پروژه شما را در اسرع وقت بررسی و پیگیری کنند. پارس وب سرور ارائه کننده انواع هاست پایتون (هاست جنگو ، هاست فلسک) می باشد.