Django admin中autocomplete_fields与Media类引入的JS冲突原因是什么

现象原因 #

1. jQuery版本冲突 #

Django Admin本身内置了适配框架逻辑的jQuery版本，autocomplete_fields组件完全依赖Admin自带的jQuery运行。你在SectionAdmin的Media配置中额外引入了jQuery 1.9.1，两个不同版本的jQuery会先后覆盖全局$/jQuery变量，导致autocomplete_fields的运行逻辑报错中断，连带后续加载的自定义JS也无法正常执行。
移除autocomplete_fields后，Admin不会加载对应组件依赖的内置jQuery逻辑，不会触发版本冲突，你的自定义JS就可以正常运行。

2. 动态元素加载时机不匹配 #

autocomplete_fields的输入框、下拉选择框都是Django Admin动态渲染生成的，渲染时机晚于静态JS的默认执行时机。如果你的card_in_section.js中包含直接绑定这些动态生成字段的事件逻辑，页面初始加载时目标元素还不存在，事件绑定会直接失效，看起来就像JS没有正常运行。

3. Admin命名空间被破坏 #

Django Admin默认会把内置jQuery绑定到django.jQuery专属命名空间下避免冲突，你额外引入的jQuery会覆盖全局变量的同时，也会打乱autocomplete_fields依赖的django.jQuery调用逻辑，触发JS报错终止整个页面的脚本执行流程。

修复建议 #

• 移除Media配置中自行引入的jQuery资源，统一使用Admin内置的jQuery：在card_in_section.js开头添加const $ = django.jQuery;做本地变量映射即可兼容原有写法。
• 涉及动态元素的事件绑定改用事件委托实现，或者将自定义逻辑包裹在django.jQuery(document).ready()回调中，确保DOM完全渲染后再执行。
• 如果需要监听inline新增行的加载事件，可以绑定Django Admin自带的formset:added事件处理inline动态新增行的逻辑。

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