部署后Django应用异常：tinymce无法导入HTMLField求助

Hey Josh, let's get this sorted out—this error is almost always tied to a version mismatch with django-tinymce. Here's how to debug and fix it step by step:

1. First, check your django-tinymce version #

The HTMLField was deprecated and removed in newer versions of django-tinymce (specifically 3.0 and above). Let's confirm what version you're running in your virtual environment:

source /home/powevtec/virtualenv/mejoshjones.com/test/3.7/bin/activate
pip show django-tinymce

2. If you're on django-tinymce 3.0+ (no HTMLField available) #

You have two solid alternatives to fix the import:

Option A: Use the official replacement field #

Swap your import for the updated field name that replaces HTMLField:

# Replace this: from tinymce import HTMLField
from tinymce.models import TinyMCEHTMLField

# Then in your model:
class YourModel(models.Model):
    content = TinyMCEHTMLField()

Option B: Use a TextField with the TinyMCE widget #

If you prefer sticking to a standard Django field but want to retain the TinyMCE editor, use this approach (great for backward compatibility):

from django.db import models
from tinymce.widgets import TinyMCE
from django.contrib import admin

class YourModel(models.Model):
    content = models.TextField()

# Enable the editor in the admin interface
@admin.register(YourModel)
class YourModelAdmin(admin.ModelAdmin):
    formfield_overrides = {
        models.TextField: {'widget': TinyMCE()},
    }

3. If you need to keep using HTMLField (for legacy code) #

If your project relies heavily on HTMLField and refactoring isn't feasible right now, install a compatible older version that still includes it:

source /home/powevtec/virtualenv/mejoshjones.com/test/3.7/bin/activate
pip install django-tinymce==2.9.0

Note: Version 2.9.0 works with Django 2.x to 3.x, which aligns well with your Python 3.7 environment.

4. Verify your Passenger deployment setup #

Make sure Passenger is using your correct virtual environment—sometimes deployments accidentally default to the system Python instead of your isolated env:

• Double-check your Passenger config to ensure it points to /home/powevtec/virtualenv/mejoshjones.com/test/3.7/bin/python
• Reinstall dependencies in the virtual env to avoid missing packages:

  source /home/powevtec/virtualenv/mejoshjones.com/test/3.7/bin/activate
  pip install -r requirements.txt
  

After making these changes, restart your Passenger app and the import error should be resolved.

内容的提问来源于stack exchange，提问作者Josh Jones