Invalid field name with unsupported characters accepted; project uploads but mobile app hangs when opening
まだ誰も着手していません。
評価
調査の方向性
QGIS plugin で、Attachment widget を持つ Photo_: という名前のフィールドを作成し、表示されている attachment pattern を設定してプロジェクトを同期することで、問題を再現します。まず、同期前にフィールド名またはプロジェクトスキーマがどこで検証されているかを追跡します。対応すべき内容には、同期前にサポートされていない名前を防止するか明確に警告すること、報告された文字を対象とするテストカバレッジ、および使用できないモバイルプロジェクトが生成されるのを避ける動作を含める必要があります。
索引モデルが issue の本文から書いたものです。
説明
Description
A layer field whose name contains invalid / unsupported characters (tested: Photo_: — characters like : | ? " *) is not rejected or warned about by the QGIS plugin. The project syncs successfully to the server. When the project is downloaded in the Mergin Maps mobile app (Android/iOS) and opened, the app stays in an indefinite “opening” state (spinner) until forcibly killed. This creates a hidden data integrity / usability issue: plugin allows creation + upload of a schema that mobile cannot handle gracefully.
Environment
PROD
Application (+ app version, build, operating system)
- QGIS version: 3.40.5-Bratislava
- Plugin version: 2025.3.3
- Desktop OS: macOS Sequoia 15.6 (reported)
- Mobile platforms: Android + iOS (both hang)
Steps to reproduce
- In QGIS, create a new Mergin Maps project.
- Add a new layer and create a text field named exactly:
Photo_:(an example containing a colon; other disallowed characters like| ? " *likely similar). - Set the field’s widget to Attachment.
- Open Mergin Maps plugin settings and define a custom attachment naming pattern referencing that field, e.g.:
@layer_name + '-' + @mm_username + '-' + format_date(now(),'ddMMyy_hhmm') - Sync the project to the server — sync completes without validation error.
- On mobile (Android or iOS), download the project.
- Attempt to open the project.
Actual results
- QGIS plugin shows no validation warning about the field name.
- Sync succeeds; project is present on server.
- Mobile app: after tapping the project to open, it remains stuck “opening” (spinner) indefinitely; no user-facing error, necessitating force-closing the app.
- Project content never loads.
Expected results
- Plugin should proactively validate field names (especially for layers with attachment widgets) and block or warn if unsupported characters are present before allowing sync.
- Either:
- (Blocking) Prevent sync until offending field names are renamed, listing all invalid characters detected.
- (Sanitizing) Automatically map / escape invalid characters (with a clear transformation note) so mobile can open the schema.
- Mobile app should not hang; if schema is invalid it should display a clear error (e.g., “Project schema contains unsupported field name: ‘Photo_:’”).
Screenshots or logs
Conclusion
Created by GitHub Copilot and supervised by a human test analyst.
- 主要言語
- Python
- スター
- 45
- フォーク
- 21
- 平均マージ
- 3日 13時間
- マージ済み PR(30日)
- 2
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
MerginMaps/qgis-plugin のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
MerginMaps/qgis-plugin#953 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
MerginMaps/qgis-plugin#848 · コメント 1 件 ·
-
Project history and Remove locally fail in projects with long paths on Windows (> 260 characters)オープンbug windows
難易度 3/5 1〜2日 初心者へのやさしさ 55/100
MerginMaps/qgis-plugin#967 ·
-
View changes and schema check use the wrong base copy for GeoPackages in subfolders対応中かも @harminius が 6 日前に担当しました。 オープンbug
MerginMaps/qgis-plugin#963 · 担当者 1 名 ·
-
Error when syncing project.対応中かも @harminius が 7 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 54/100
MerginMaps/qgis-plugin#960 · コメント 2 件 · 担当者 1 名 ·
MerginMaps/qgis-plugin の issue をすべて見る
似ている issue
-
integration: media_player
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
home-assistant/core#193344 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 82/100
daniel-ospina/tortoise#13607 ·
メンテナーはふだん 1 日以内に返信
-
documentation priority: medium
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
メンテナーはふだん 1 日以内に返信
-
needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信