本文针对 Django 1.8.4 中为 TabularInline 添加分页功能时出现的 getfullargspec 兼容性报错，提供可落地的修复方案，包括替代库适配、废弃参数迁移及手动分页实现。
本文针对 django 1.8.4 中为 `tabularinline` 添加分页功能时出现的 `getfullargspec` 兼容性报错，提供可落地的修复方案，包括替代库适配、废弃参数迁移及手动分页实现。
在 Django 1.8.4 这一较老但仍在部分遗留系统中使用的版本中，为 ModelAdmin 的 inlines 添加分页支持存在显著限制：官方 Admin 不原生支持内联模型分页，而第三方库（如 django-admin-inline-paginator）往往面向 Django ≥2.0 开发，其 TabularInlinePaginated 类在 Python 3.6+ 下调用 inspect.getargspec() 时会因签名解析失败抛出 Function has keyword-only parameters or annotations... 错误——这本质上是旧版 Django Admin 内部反射逻辑与新 Python 版本 inspect API 不兼容所致。
✅ 推荐解决方案：弃用不兼容库，改用轻量级手动分页
由于 django-admin-inline-paginator 在 Django 1.8 上无法可靠工作，且升级 Django 是最根本但成本最高的解法，我们推荐以下零依赖、向后兼容的实践方案：
1. 移除已废弃的 related_lookup_fields
Django 1.8 中 related_lookup_fields 已被标记为废弃（DEPRECATED），应替换为 autocomplete_fields（需配合 raw_id_fields 使用）或直接移除：
class ArticleInline(GrappelliSortableHiddenMixin, admin.TabularInline):
model = ArticleSection.articles.through
raw_id_fields = ("article",)
# ❌ 删除以下整行（Django 1.8 不支持 related_lookup_fields）
# related_lookup_fields = {'fk': ['article']}
# ✅ 替换为（若需搜索增强，且已配置 autocomplete）
# autocomplete_fields = ["article"]
extra = 1⚠️ 注意：
autocomplete_fields在 Django 1.8 中不可用（首次引入于 Django 2.0），因此此处应直接删除related_lookup_fields行，仅保留raw_id_fields即可确保外键字段以 ID 输入框形式正常工作。
Django Unfold下载提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
2. 用 max_num + 前端提示实现“伪分页”控制
虽非真分页，但可有效避免内联列表过长导致页面卡顿。在 ArticleInline 中设置合理上限，并在 Admin 页面添加说明：
class ArticleInline(GrappelliSortableHiddenMixin, admin.TabularInline):
model = ArticleSection.articles.through
raw_id_fields = ("article",)
extra = 1
max_num = 15 # 限制最多显示/编辑 15 条关联记录
# 可选：添加帮助文本引导用户分批操作
verbose_name = "关联文章（每页最多15条，请分批管理）"
verbose_name_plural = "关联文章（每页最多15条，请分批管理）"3. （进阶）自定义 Inline 模板实现服务端分页（需模板覆盖）
若必须实现真分页，可通过重写 change_form.html 模板 + 自定义视图实现，但复杂度高。更务实的做法是：将关联管理逻辑移出 Inline，改为独立 ModelAdmin 页面：
# admin.py
@admin.register(M2MSectionArticle)
class M2MSectionArticleAdmin(admin.ModelAdmin):
list_display = ('section', 'article', 'position', 'visible_from', 'visible_to')
list_filter = ('section', 'visible_from', 'visible_to')
list_per_page = 20 # ✅ 原生支持分页
raw_id_fields = ('section', 'article')
ordering = ('section', 'position')然后在 ArticleSectionsAdmin 中移除 ArticleInline，改用 readonly_fields 提示跳转链接：
class ArticleSectionsAdmin(reversion.VersionAdmin):
list_display = ('name', 'slug', 'template_file_name')
# inlines = [ArticleInline] # ❌ 移除
readonly_fields = ('_manage_articles_link',)
def _manage_articles_link(self, obj):
if obj and obj.pk:
return format_html(
'<a href="{}">→ 管理关联文章（分页列表）</a>',
reverse('admin:your_app_m2msectionarticle_changelist') + f'?section__id__exact={obj.pk}'
)
return '请先保存该 Section'
_manage_articles_link.short_description = '关联文章管理'总结与建议
-
根本原因：
django-admin-inline-paginator与 Django 1.8 + Python 3.6 的inspectAPI 存在不兼容，非代码错误而是生态断层。 -
立即生效方案：删除
related_lookup_fields，使用max_num控制内联数量，辅以独立 ModelAdmin 管理多对多关系。 -
长期建议：将项目升级至受支持的 Django 版本（≥3.2 LTS），届时可无缝使用
django-admin-inline-paginator或 Django 4.1+ 原生InlineModelAdmin.per_page（Django 4.1+ 引入）。
此方案无需引入外部依赖、不修改核心框架、完全兼容 Django 1.8.4 与 Python 3.6.15，兼顾稳定性与可维护性。
