Skip to content

SPFx Teams tab initial load not working - refresh needed #10866

@mdanielcristian

Description

@mdanielcristian

Target SharePoint environment

SharePoint Online

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

💥 SharePoint Framework

Developer environment

Windows

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: Chrome 148.0.7778.169
  • SPFx version: 1.22.2
  • Node.js version: 22.22.0

Describe the bug / error

An SPFx web part configured as a Microsoft Teams channel tab fails to load in Teams web (and desktop client) after a full browser page refresh. The tab remains blank/stuck and the expected SharePoint-hosted SPFx iframe does not load. If the user right-clicks the tab and refreshes only the tab, the same app loads successfully.

This is an app that is deployed in production since 2021 and we made no changes to the teams app manifest or to the webpart manifest recently.

Steps to reproduce

  1. Add a SPFx webpart as a tab in a Team using the web version of teams
  2. Full refresh the browser window
  3. Go to the previously added tab
  4. The tab doesn't load, a blank page is displayed indefinitely. If I right click the MS Teams tab and refresh it, it loads

Network tab:
Image

Console warnings that appear when clicking on the tab first time after a refresh:

Image

Expected behavior

The tab loads without requiring a refresh.

Metadata

Metadata

Assignees

Labels

area:spfx-msteamsCategory: SharePoint Framework & Microsoft Teams supportsharepoint-developer-supportsharepoint-developer-supporttype:bug-suspectedSuspected bug (not working as designed/expected). See “type:bug-confirmed” for confirmed bugs.

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions