From b96e4c04b666b1044555d7a32f64e83cbad57b03 Mon Sep 17 00:00:00 2001
From: brian <bdnettleton@gmail.com>
Date: Mon, 6 Jan 2025 17:50:44 -0800
Subject: [PATCH] [5.2.x] Fixed #36061 -- Added migration support for
 ManyToManyField.through_fields.

Added through_fields support to ManyToManyField.deconstruct.
Thanks to Simon Charette for pointers and the review.

Backport of b13b8684a04d0bc1081104c5973c62c27dc673b0 from main.
---
 AUTHORS                             |  1 +
 django/db/models/fields/related.py  |  2 ++
 tests/field_deconstruction/tests.py | 17 +++++++++++++++++
 3 files changed, 20 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index 9a76e8879e..e3389edbf5 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -180,6 +180,7 @@ answer newbie questions, and generally made Django that much better:
     Brian Fabian Crain <http://www.bfc.do/>
     Brian Harring <ferringb@gmail.com>
     Brian Helba <brian.helba@kitware.com>
+    Brian Nettleton <bdnettleton@gmail.com>
     Brian Ray <http://brianray.chipy.org/>
     Brian Rosner <brosner@gmail.com>
     Bruce Kroeze <https://coderseye.com/>
diff --git a/django/db/models/fields/related.py b/django/db/models/fields/related.py
index de8fe9c339..e873e5ca86 100644
--- a/django/db/models/fields/related.py
+++ b/django/db/models/fields/related.py
@@ -1819,6 +1819,8 @@ class ManyToManyField(RelatedField):
                 kwargs["through"] = self.remote_field.through
             elif not self.remote_field.through._meta.auto_created:
                 kwargs["through"] = self.remote_field.through._meta.label
+        if through_fields := getattr(self.remote_field, "through_fields", None):
+            kwargs["through_fields"] = through_fields
         # If swappable is True, then see if we're actually pointing to the target
         # of a swap.
         swappable_setting = self.swappable_setting
diff --git a/tests/field_deconstruction/tests.py b/tests/field_deconstruction/tests.py
index 3b10ee0091..41353cbaaf 100644
--- a/tests/field_deconstruction/tests.py
+++ b/tests/field_deconstruction/tests.py
@@ -516,6 +516,23 @@ class FieldDeconstructionTests(SimpleTestCase):
         self.assertEqual(path, "django.db.models.ManyToManyField")
         self.assertEqual(args, [])
         self.assertEqual(kwargs, {"to": "auth.permission", "through": "auth.Group"})
+        # Test through_fields
+        field = models.ManyToManyField(
+            "auth.Permission",
+            through="auth.Group",
+            through_fields=("foo", "permissions"),
+        )
+        name, path, args, kwargs = field.deconstruct()
+        self.assertEqual(path, "django.db.models.ManyToManyField")
+        self.assertEqual(args, [])
+        self.assertEqual(
+            kwargs,
+            {
+                "to": "auth.permission",
+                "through": "auth.Group",
+                "through_fields": ("foo", "permissions"),
+            },
+        )
         # Test custom db_table
         field = models.ManyToManyField("auth.Permission", db_table="custom_table")
         name, path, args, kwargs = field.deconstruct()