在 Linux 环境下运行 Django 项目时，时间相关错误通常源于时区配置不当、系统时间与 Python/Django 时间处理不一致等问题。以下是一些常见问题及其解决方法。 ### 使用 `timezone.utcfromtimestamp` 正确转换时间戳 Django 提供了 `django.utils.timezone` 模块来处理带有时区信息的时间对象。若需要将时间戳转换为 UTC 时间并进一步转换为本地时间，应使用 `timezone.utcfromtimestamp(timestamp)` 方法： ```python from django.utils import timezone timestamp = 1712323200 # 示例时间戳 utc_time = timezone.utcfromtimestamp(timestamp) local_time = utc_time.astimezone(timezone.get_default_timezone()) ``` 此方法确保生成的 `datetime` 对象是时区感知的，并与 Django 配置的默认时区保持一致[^1]。 ### 常见错误及修复 如果代码中误将 `timezone` 导入为 `datetime` 的别名，例如： ```python from django.utils import timezone as datetime datetime.now() ``` 这会导致调用 `now()` 时出现属性错误（`AttributeError`）。正确的做法是分别导入标准库和 Django 模块： ```python from django.utils import timezone import datetime as dt # 获取当前时间（时区感知） current_time = timezone.now() ``` 这样可以避免命名冲突并正确使用 Django 的时区支持功能[^4]。 ### 在模型或视图中使用时间戳转换 在涉及 JWT token 生成等场景时，建议使用 `timezone.now()` 来获取当前时间，以确保返回的是时区感知对象： ```python from django.utils import timezone import jwt from datetime import timedelta def _generate_jwt_token(self): token = jwt.encode({ 'exp': timezone.now() + timedelta(days=1), 'iat': timezone.now(), 'data': { 'name': self.name } }, settings.SECRET_KEY, algorithm='HS256') return token.decode('utf-8') ``` 通过这种方式生成的时间戳字段会自动带上时区信息，避免了因时区差异而导致的安全隐患或逻辑错误[^2]。 ### 系统时间与数据库时间不一致 在 Linux 上部署 Django 项目时，若数据库服务器（如 PostgreSQL 或 MySQL）运行在不同的时区，也可能导致时间显示异常。建议统一配置系统时间、Python 运行环境以及数据库的时区设置为 UTC，并在应用层进行本地化转换。 对于 PostgreSQL 数据库，可以在连接参数中指定时区： ```python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'mydb', 'USER': 'myuser', 'PASSWORD': 'mypassword', 'HOST': 'localhost', 'PORT': '', 'OPTIONS': { 'timezone': 'UTC' } } } ``` 此外，在 Linux 系统中可通过如下命令查看和修改当前时区： ```bash timedatectl sudo timedatectl set-timezone Asia/Shanghai ``` 这有助于保证整个系统时间的一致性[^3]。 ---