{"record":{"id":"50448bc4de35f6f1","repo":"siyuan-note/siyuan","slug":"url-value-is-missing","errorCode":null,"errorMessage":"URL value is missing","messagePattern":"URL value is missing","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"kernel/av/new_item_template.go","lineNumber":388,"sourceCode":"\t\tif nil == value.Date {\n\t\t\treturn nil, errors.New(\"date value is missing\")\n\t\t}\n\t\tvalue.Text, value.Number, value.MSelect, value.URL, value.Email, value.Phone, value.MAsset, value.Checkbox, value.Relation = nil, nil, nil, nil, nil, nil, nil, nil, nil\n\tcase KeyTypeSelect, KeyTypeMSelect:\n\t\tvar selections []*ValueSelect\n\t\tfor _, selection := range value.MSelect {\n\t\t\tif nil != selection && \"\" != strings.TrimSpace(selection.Content) {\n\t\t\t\tselections = append(selections, selection)\n\t\t\t}\n\t\t}\n\t\tif KeyTypeSelect == key.Type && 1 < len(selections) {\n\t\t\tselections = selections[:1]\n\t\t}\n\t\tvalue.MSelect = selections\n\t\tvalue.Text, value.Number, value.Date, value.URL, value.Email, value.Phone, value.MAsset, value.Checkbox, value.Relation = nil, nil, nil, nil, nil, nil, nil, nil, nil\n\tcase KeyTypeURL:\n\t\tif nil == value.URL {\n\t\t\treturn nil, errors.New(\"URL value is missing\")\n\t\t}\n\t\tvalue.Text, value.Number, value.Date, value.MSelect, value.Email, value.Phone, value.MAsset, value.Checkbox, value.Relation = nil, nil, nil, nil, nil, nil, nil, nil, nil\n\tcase KeyTypeEmail:\n\t\tif nil == value.Email {\n\t\t\treturn nil, errors.New(\"email value is missing\")\n\t\t}\n\t\tvalue.Text, value.Number, value.Date, value.MSelect, value.URL, value.Phone, value.MAsset, value.Checkbox, value.Relation = nil, nil, nil, nil, nil, nil, nil, nil, nil\n\tcase KeyTypePhone:\n\t\tif nil == value.Phone {\n\t\t\treturn nil, errors.New(\"phone value is missing\")\n\t\t}\n\t\tvalue.Text, value.Number, value.Date, value.MSelect, value.URL, value.Email, value.MAsset, value.Checkbox, value.Relation = nil, nil, nil, nil, nil, nil, nil, nil, nil\n\tcase KeyTypeMAsset:\n\t\tvar assets []*ValueAsset\n\t\tfor _, asset := range value.MAsset {\n\t\t\tif nil != asset && \"\" != strings.TrimSpace(asset.Content) {\n\t\t\t\tif AssetTypeFile != asset.Type && AssetTypeImage != asset.Type {\n\t\t\t\t\treturn nil, fmt.Errorf(\"invalid asset type [%s]\", asset.Type)","sourceCodeStart":370,"sourceCodeEnd":406,"githubUrl":"https://github.com/siyuan-note/siyuan/blob/251596fc0de2f9528c00c224252fd073a99973f4/kernel/av/new_item_template.go#L370-L406","documentation":"normalizeNewItemTemplateValue for KeyTypeURL requires value.URL != nil — the URL sub-struct holds the link content and optional description. A Static-mode value on a URL column that omits the URL pointer is rejected.","triggerScenarios":"Static mode on a URL column but Value.URL is nil; client sent &av.Value{} with no URL sub-pointer; type mismatch in an import.","commonSituations":"Partial Value from a client that populated a different sub-field; column-type change after template authoring.","solutions":["Set Value.URL = &av.ValueURL{Content: \"https://example.com\"} when key.Type is KeyTypeURL.","Ensure the sub-pointer matches key.Type exactly.","Validate shape client-side before submit."],"exampleFix":"// before\n&av.Value{}  // key.Type == KeyTypeURL\n// after\n&av.Value{URL: &av.ValueURL{Content: \"https://example.com\"}}","handlingStrategy":"type-guard","validationCode":"if key.Type == av.KeyTypeURL && value.URL == nil {\n    value.URL = &av.ValueURL{Content: \"\"}\n}","typeGuard":"func hasURLValue(v *av.Value) bool { return v != nil && v.URL != nil }","tryCatchPattern":null,"preventionTips":["Set Value.URL for URL columns before submit.","Match the Value sub-pointer to key.Type exactly.","Add a client-side shape check before the save call."],"tags":["av","new-item-template","url","value","validation"],"backgroundTag":null,"analyzedSha":"251596fc0de2f9528c00c224252fd073a99973f4","analyzedAt":"2026-08-12T21:18:37.123Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}