SPFx webpart can't be loaded: Cannot read properties of undefined (reading 'id')

[miguelisidoro]

Target SharePoint environment

SharePoint Online

What SharePoint development model, framework, SDK or API is this about?

💥 SharePoint Framework

Developer environment

None

What browser(s) / client(s) have you tested

• 💥 Internet Explorer
• 💥 Microsoft Edge
• 💥 Google Chrome
• 💥 FireFox
• 💥 Safari
• mobile (iOS/iPadOS)
• mobile (Android)
• not applicable
• other (enter in the "Additional environment details" area below)

Additional environment details

• browser version: Edge 144.0.3719.115
• SPFx version: 1.22.2
• Node.js version: 22.22.0

Describe the bug / error

I am migrating a SPFx solution from 1.9.1 to SPFx 1.22.2. All steps of the migration process were completely sucessfully and all SCSS, TypeScript an eslint errors were solved and the solution is building sucessfully.

However, I am getting this error after deploying the web part to the Site Collection App Catalog:

Could not load my-web-part in require. TypeError: Cannot read properties of undefined (reading 'id')
at sp-pages-assembly_en-us_90032a83f8eaa3f8b6d063951bd8f3bb.js:227:12727
at new Promise ()
at e.loadComponent (sp-pages-assembly_en-us_90032a83f8eaa3f8b6d063951bd8f3bb.js:227:12695)
at sp-pages-assembly_en-us_90032a83f8eaa3f8b6d063951bd8f3bb.js:227:6401
at async Promise.all (/sites/QAS/SitePages/index 0)

I have been searching the web and talking to Copilot but after almost one day of researching and troubleshooting, I was unable to successfully make SharePoint to load the web part.

Can anyone help me to solve this error?

Thanks

Steps to reproduce

1. heft clean && heft test --production && heft package-solution --production
2. Upload the new version to the Site Collection App Catalog
3. Test the page where the web part is included

Expected behavior

The web part to work properly.

[Ashlesha-MSFT]

Hello @miguelisidoro,
Thank you for bringing this issue to our attention. We will look into it and get back to you shortly.
If you don’t receive a reply within two working days, please use this escalation form to escalate.

[Ashlesha-MSFT]

@miguelisidoro,
I tried to reproduce this issue by migrating a SPFx 1.21.1 project to 1.22.2 using the Heft-based toolchain, but I was unable to reproduce the error. The web part loaded successfully without any "Cannot read properties of undefined (reading 'id')" error.

Have you followed the official migration guide?
https://learn.microsoft.com/en-us/sharepoint/dev/spfx/toolchain/migrate-gulptoolchain-hefttoolchain

[miguelisidoro]

@Ashlesha-MSFT ,

I have used M365 CLI.

I used the command m365 spfx project upgrade --toVersion 1.22.2 --output md > upgrade-report.md and followed all the steps in the .md file.

[miguelisidoro]

Problem solved. I recreated the solution from scratch and copied the src folder and solved every build errors.

Thanks