When migrating from On-Prem to SharePoint ShareGate does not use the users UPN instead either using property extraction or if that fails NTFS metadata. The issue is allot of the time when this fails it pick up the SAM account name creating an orphaned user in SharePoint.

Could Sharegate not also check the local AD for a matching UPN for the user as if using Azure AD sync this should (in theory) match.