核心问题分析 #

从日志和配置来看，主要问题集中在路径格式错误、离线模式未完全启用，以及可能的瓦片结构/权限问题：

• 日志显示Offline directory: undefined：这是因为localPlugin.parameters是数组而非对象，直接用键名访问会失败，但更关键的是路径格式不符合插件要求；
• 插件仍加载在线瓦片：未完全禁用在线数据源，且离线目录配置错误导致插件找不到本地瓦片。

修复步骤 #

1. 修正离线目录路径格式 #

OSM插件的osm.mapping.offline.directory参数不需要file:///前缀，直接使用本地绝对路径：

PluginParameter {
    name: "osm.mapping.offline.directory"
    value: "C:/qt_tiles" // 也可使用转义反斜杠格式 "C:\\qt_tiles"
}

2. 完全启用离线模式 #

添加参数强制插件使用离线后端，彻底跳过在线请求：

PluginParameter {
    name: "osm.mapping.provider.backend"
    value: "offline"
}

3. 确保瓦片目录结构与坐标匹配 #

本地瓦片必须严格遵循Z/X/Y.png的层级结构（Z为缩放级别，X/Y为瓦片坐标）：

• 你的地图中心坐标(54.3283, 10.1653)、缩放级别15，需确保C:/qt_tiles/15/[对应X]/[对应Y].png这类瓦片存在；
• 确认本地瓦片的缩放级别、坐标完全覆盖地图当前显示的区域。

4. 修正日志代码（可选） #

由于localPlugin.parameters是数组，无法直接通过键名访问，修改日志代码以正确获取参数值：

Component.onCompleted: {
    console.log("Map plugin initialized: " + localPlugin.name)
    // 遍历参数数组查找离线目录
    for (let param of localPlugin.parameters) {
        if (param.name === "osm.mapping.offline.directory") {
            console.log("Offline directory: " + param.value)
        }
    }
    console.log("Available parameters: " + JSON.stringify(localPlugin.parameters))
    console.log("Qt version: " + Qt.versionMajor + "." + Qt.versionMinor + "." + Qt.versionPatch)
}

5. 检查文件权限 #

Windows下C盘根目录可能存在读写权限限制，建议将瓦片目录移至非系统盘（如D:/qt_tiles），或给C:/qt_tiles目录添加当前用户的读写权限。

修改后的完整QML代码 #

/* Qt includes ---------------------------------------------------------------------------------*/
import QtQuick
import QtQuick.Window
import QtLocation
import QtPositioning
import QtQuick.Controls

Item {
    width: 800
    height: 600

    Plugin {
        id: localPlugin
        name: "osm"

        PluginParameter {
            name: "osm.mapping.providersrepository.disabled"
            value: true
        }

        PluginParameter {
            name: "osm.mapping.offline.directory"
            value: "C:/qt_tiles"
        }

        PluginParameter {
            name: "osm.mapping.provider.backend"
            value: "offline"
        }

        PluginParameter {
            name: "osm.mapping.cache.disk.size"
            value: 0
        }

        PluginParameter {
            name: "osm.mapping.highdpi_tiles"
            value: false
        }

        Component.onCompleted: {
            console.log("Map plugin initialized: " + localPlugin.name)
            for (let param of localPlugin.parameters) {
                if (param.name === "osm.mapping.offline.directory") {
                    console.log("Offline directory: " + param.value)
                }
            }
            console.log("Available parameters: " + JSON.stringify(localPlugin.parameters))
            console.log("Qt version: " + Qt.versionMajor + "." + Qt.versionMinor + "." + Qt.versionPatch)
        }
    }

    Map {
        id: map
        anchors.fill: parent
        plugin: localPlugin
        center: QtPositioning.coordinate(54.3283, 10.1653)
        zoomLevel: 15
    }
}

验证步骤 #

1. 断网后运行程序，查看是否能加载本地瓦片；
2. 检查日志中Offline directory是否正确显示为设置的路径；
3. 若仍无法加载，确认瓦片文件名、路径是否与地图当前显示的缩放级别、坐标完全匹配。

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