.NET 9 MAUI Android应用无法响应设备方向变化的原因排查

以下是可能导致你的应用无法感知设备方向变化的核心原因，按排查优先级排序：

1. 应用/页面被强制固定屏幕方向 #

这是最常见的触发原因，若后续修改中不小心设置了固定方向，会直接阻断所有方向变化事件：

• 检查ContentPage的XAML属性：确认SplashScreen页面或全局页面是否设置了固定方向的Orientation属性：

  <!-- 错误示例：强制固定为竖屏 -->
  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               x:Class="YourApp.SplashScreen"
               Orientation="Portrait">
  

• 检查AndroidManifest.xml配置：查看<activity>节点是否添加了锁定方向的属性：

  <!-- 错误示例：强制竖屏 -->
  <activity android:name=".MainActivity"
            android:screenOrientation="portrait">
  

• 检查MAUI全局配置：确认MauiProgram.cs中是否通过自定义处理器强制设置了方向：

  // 错误示例：全局固定屏幕方向
  builder.ConfigureMauiHandlers(handlers =>
  {
      #if ANDROID
          handlers.AddHandler<ContentPage, FixedOrientationPageHandler>();
      #endif
  });
  

2. SplashScreen页面生命周期异常 #

若你的启动页为SplashScreen，需确认页面是否在应用启动后被正确保留：

• 检查应用启动逻辑，是否在SplashScreen显示后立即导航到其他页面，导致测试页面已不在前台，无法触发事件。
• 确认SplashScreen的宿主容器（如NavigationPage）是否正确处理生命周期，未被意外销毁或隐藏。

3. Android主题配置锁定方向 #

检查Platforms/Android/Resources/values/styles.xml中的主题设置，是否包含锁定方向的属性：

<!-- 错误示例：主题强制竖屏 -->
<style name="MyTheme.Splash" parent="Theme.Maui.Light">
    <item name="android:screenOrientation">portrait</item>
</style>

你设置的Theme = "@style/MyTheme.Splash"若包含该属性，会直接覆盖Activity的配置。

4. ConfigurationChanges参数冲突或设置错误 #

虽然你尝试过调整ConfigurationChanges，但需注意：

• 当Activity设置ConfigurationChanges后，Android系统不会重建Activity，而是直接调用OnConfigurationChanged，但如果应用在其他地方固定了方向，该方法依然不会触发。
• 避免在AndroidManifest.xml的<application>节点重复设置ConfigurationChanges，这会与Activity的配置产生冲突。

5. .NET 9 MAUI版本兼容性问题 #

若问题出现在升级.NET 9或更新NuGet包之后，可能是版本兼容bug：

• 清理项目（删除bin/obj文件夹）后重新生成解决方案。
• 确保所有MAUI相关NuGet包版本一致，无混合版本的情况。

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